@a3s-lab/office 0.37.0 → 0.37.1

package/dist/9333.js

@@ -1846,4 +1846,4 @@ function work_spreadsheet_page_setup_boundedInteger(value, minimum, maximum, fal
 function work_spreadsheet_page_setup_boundedNumber(value, minimum, maximum, fallback) {
     return 'number' == typeof value && Number.isFinite(value) && value >= minimum && value <= maximum ? value : fallback;
 }
-export { DEFAULT_PROTECTION_HINT, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, SPREADSHEET_CONDITIONAL_ICON_SETS, XLSX_GRADIENT_FILL_CELL_KEY, XLSX_PATTERN_FILL_CELL_KEY, activeXlsxGradientFill, activeXlsxPatternFill, applyXlsxSemanticColorOrigin, attachSpreadsheetShownCommentCells, createXlsxColorResolver, decodeXlsxCellAddress, defaultSpreadsheetColorScaleThresholds, defaultSpreadsheetConditionalIconThresholds, defaultSpreadsheetDataBarOptions, defaultXlsxBorder, defaultXlsxFill, deleteXlsxGradientFill, deleteXlsxPatternFill, drawSpreadsheetConditionalIcon, editableRangeCellCount, editableRangeRequiresCredentials, effectiveSpreadsheetPageSetup, ensureXlsxStyleCollection, freezeImportedSpreadsheetCell, importedSheetProtectionAuthority, isSpreadsheetConditionalComparisonOperator, isSpreadsheetConditionalIconSetName, normalizeSheetProtectionAuthority, normalizeSpreadsheetConditionalIconSetFormat, normalizeSpreadsheetConditionalVisualOptions, normalizeSpreadsheetPaperSize, normalizeXlsxGradientFill, normalizeXlsxPatternFill, normalizeXlsxSemanticColorOrigin, prepareXlsxSemanticPalette, protectedSheetCount, readXlsxGradientFill, readXlsxPatternFill, readXlsxSemanticColorOrigin, registerDerivedSpreadsheetMatrix, registerImportedSpreadsheetMatrix, resolveXlsxColor, sameSpreadsheetHistoryValue, setXlsxBorderLine, setXlsxColorChild, setXlsxToggleChild, setXlsxUnderlineChild, setXlsxValueChild, sheetHasProtectionState, sheetProtectionAuthority, spreadsheetConditionalComparisonNeedsUpperValue, spreadsheetConditionalIconForValue, spreadsheetConditionalIconSetCount, spreadsheetConditionalThresholdValue, spreadsheetConditionalThresholdsEqual, spreadsheetMatrixProfile, spreadsheetProtectionKey, unlockedCellCount, withEditableRange, withSheetProtection, withSheetSelectionPermissions, withXlsxCellStyleOrigin, withXlsxGradientFill, withXlsxPatternFill, withoutEditableRange, writeXlsxAlignment, xlsxCellAddress, xlsxCellStyleOrigin, xlsxCellStyleOriginSemanticColors, xlsxColorElementMatchesOrigin, xlsxGradientFillFallbackColor, xlsxGradientFillKey, xlsxGradientFillSemanticColors, xlsxPatternFillKey, xlsxPatternFillSemanticColors, xlsxPatternFillTypes, xlsxRgbColor, xlsxSemanticColorMatchesValue, xlsxSemanticColorOriginKey, xlsxSemanticColorOriginSupported, xlsxWorksheetCellEntries };
+export { DEFAULT_PROTECTION_HINT, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, SPREADSHEET_CONDITIONAL_ICON_SETS, XLSX_GRADIENT_FILL_CELL_KEY, XLSX_PATTERN_FILL_CELL_KEY, activeXlsxGradientFill, activeXlsxPatternFill, applyXlsxSemanticColorOrigin, attachSpreadsheetShownCommentCells, createXlsxColorResolver, decodeXlsxCellAddress, defaultSpreadsheetColorScaleThresholds, defaultSpreadsheetConditionalIconThresholds, defaultSpreadsheetDataBarOptions, defaultXlsxBorder, defaultXlsxFill, deleteXlsxGradientFill, deleteXlsxPatternFill, drawSpreadsheetConditionalIcon, editableRangeCellCount, editableRangeRequiresCredentials, effectiveSpreadsheetPageSetup, ensureXlsxStyleCollection, freezeImportedSpreadsheetCell, importedSheetProtectionAuthority, isSpreadsheetConditionalComparisonOperator, isSpreadsheetConditionalIconSetName, normalizeSheetProtectionAuthority, normalizeSpreadsheetConditionalIconSetFormat, normalizeSpreadsheetConditionalVisualOptions, normalizeSpreadsheetPaperSize, normalizeXlsxGradientFill, normalizeXlsxPatternFill, normalizeXlsxSemanticColorOrigin, prepareXlsxSemanticPalette, protectedSheetCount, readXlsxGradientFill, readXlsxPatternFill, readXlsxSemanticColorOrigin, registerDerivedSpreadsheetMatrix, registerImportedSpreadsheetMatrix, resolveXlsxColor, sameSpreadsheetHistoryValue, setXlsxBorderLine, setXlsxColorChild, setXlsxToggleChild, setXlsxUnderlineChild, setXlsxValueChild, sheetHasProtectionState, sheetProtectionAuthority, spreadsheetConditionalComparisonNeedsUpperValue, spreadsheetConditionalIconAppearance, spreadsheetConditionalIconForValue, spreadsheetConditionalIconSetCount, spreadsheetConditionalThresholdValue, spreadsheetConditionalThresholdsEqual, spreadsheetMatrixProfile, spreadsheetProtectionKey, unlockedCellCount, withEditableRange, withSheetProtection, withSheetSelectionPermissions, withXlsxCellStyleOrigin, withXlsxGradientFill, withXlsxPatternFill, withoutEditableRange, writeXlsxAlignment, xlsxCellAddress, xlsxCellStyleOrigin, xlsxCellStyleOriginSemanticColors, xlsxColorElementMatchesOrigin, xlsxGradientFillFallbackColor, xlsxGradientFillKey, xlsxGradientFillSemanticColors, xlsxPatternFillKey, xlsxPatternFillSemanticColors, xlsxPatternFillTypes, xlsxRgbColor, xlsxSemanticColorMatchesValue, xlsxSemanticColorOriginKey, xlsxSemanticColorOriginSupported, xlsxWorksheetCellEntries };

package/dist/core.d.ts

@@ -29,6 +29,7 @@ export type { WorkGetMarkdownSelectionMenuItems as GetMarkdownSelectionMenuItems
 export { exportWorkArtifactPdf as downloadArtifactPdf, type WorkPdfExportOptions as PdfExportOptions, workPdfPagesForExport as pdfPagesForExport, } from './internal/features/work/work-pdf-export';
 export type { PdfPageOrganizationExport } from './internal/features/work/editors/use-pdf-page-organization';
 export { defaultPptxRuntimeUrl } from './internal/features/work/work-presentation-file-io';
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, type SpreadsheetSortCustomListStore, } from './internal/features/work/editors/spreadsheet-sort-custom-list-store';
 export { forgetWorkSourceBlob as forgetSourceBlob, readWorkSourceBlob as readSourceBlob, rememberWorkSourceBlob as registerSourceBlob, } from './internal/features/work/work-repository';
 export { createWorkArtifact as createArtifact, createWorkId as createOfficeId, WORK_TEMPLATES as officeTemplates, } from './internal/features/work/work-templates';
 export type { WorkArtifact as OfficeArtifact, WorkArtifactContent as OfficeArtifactContent, WorkArtifactKind as OfficeArtifactKind, WorkCompatibilityIssue as CompatibilityIssue, WorkCompatibilityReport as CompatibilityReport, WorkDocumentContent as DocumentContent, WorkMarkdownContent as MarkdownContent, WorkPdfContent as PdfContent, WorkPresentationContent as PresentationContent, WorkSourceFile as SourceFile, WorkSpreadsheetContent as SpreadsheetContent, WorkTemplate as OfficeTemplate, } from './internal/features/work/work-types';

package/dist/core.js

@@ -5,7 +5,7 @@ import { OFFICE_COLLABORATION_PROTOCOL as WORK_OFFICE_COLLABORATION_PROTOCOL, Of
 import { directChildren, OoxmlPackage as work_ooxml_package_OoxmlPackage, parseXml, firstDescendant, directChild, descendants, createArtifact as createWorkArtifact, xmlContainsAnyElement, createOfficeId as createWorkId, attribute as work_ooxml_package_attribute } from "./4121.js";
 import { fileNameWithoutExtension, work_file_download_downloadBlob, mountWorkLiveDocumentCapture, importWorkDocumentFile, moveWorkSourceBlob, materializeWorkDocumentContent as work_document_model_codec_materializeWorkDocumentContent, createWorkDocumentModel, work_file_download_safeFileName, documentPageSurfaceGeometryForElement, registerSourceBlob as rememberWorkSourceBlob, documentModelForContent, readSourceBlob as readWorkSourceBlob, createWorkDocumentExtensions, positionWorkLiveDocumentCapture, createWorkDocumentBlob } from "./4174.js";
 import { normalizeSpreadsheetPrintTitleRows, sparseMatrixColumnCount, normalizeSpreadsheetPrintArea, parseSpreadsheetPrintTitles, isValidSpreadsheetDefinedName, formatSpreadsheetCellRanges, stripSpreadsheetSheetQualifier, editableSpreadsheetFormula, sparseArrayEntries, qualifySpreadsheetRange, refreshSpreadsheetPivotTables, parseSpreadsheetCellRanges, normalizeSpreadsheetPrintTitleColumns } from "./8715.js";
-import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, directXlsxAlignment, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, sheetHasXlsxRichTextCells, spreadsheetExplicitTextOrientationFromCell, activeXlsxNativeFill, readXlsxRichTextCells, normalizeSpreadsheetDateValidationBoundary, createXlsxRichTextReadContext, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, normalizeSpreadsheetTableTotalsLabel, activeXlsxSemanticColorOrigin, writeXlsxRichTextCells, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./3266.js";
+import { xlsxColorMatches, xlsxRichTextCellText, spreadsheetCellValueWithDiagonalBorder, xlsxRichTextStyleOrigins, normalizeSpreadsheetDataValidationErrorStyle, workSpreadsheetAutoFilterCriteriaEntries, directXlsxAlignment, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTextOrientationFromXlsx, directXlsxFontStyle, hasXlsxDirectFontStyle, applyImportedXlsxRichText, xlsxStyleCollectionIndex, sheetHasXlsxRichTextCells, spreadsheetExplicitTextOrientationFromCell, activeXlsxNativeFill, workSpreadsheetHasUnescapedWildcard, readXlsxRichTextCells, createXlsxRichTextReadContext, normalizeSpreadsheetDateValidationBoundary, boundedSpreadsheetDataValidationText, xlsxNativeFillKey, xlsxBooleanAttribute, xlsxAlignmentMatches, xlsxBorderLineMatches, spreadsheetTextOrientationCellStyle, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, workSpreadsheetSheetWithImportedAutoFilterCriteria, xlsxUnderlineStyle, spreadsheetUnderlineCellValueFromXlsx, xlsxToggleEnabled, normalizeSpreadsheetTableTotalsLabel, activeXlsxSemanticColorOrigin, writeXlsxRichTextCells, xlsxNativeFillSemanticColors, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, spreadsheetUnderlineCellValueFromSheetJs } from "./5416.js";
 import { freezeImportedSpreadsheetCell, readXlsxGradientFill, withXlsxPatternFill, xlsxCellStyleOriginSemanticColors, setXlsxToggleChild, withXlsxCellStyleOrigin, normalizeSpreadsheetConditionalVisualOptions, xlsxColorElementMatchesOrigin, withXlsxGradientFill, ensureXlsxStyleCollection, xlsxCellStyleOrigin, xlsxSemanticColorOriginKey, readXlsxPatternFill, isSpreadsheetConditionalComparisonOperator, registerImportedSpreadsheetMatrix, defaultSpreadsheetConditionalIconThresholds, readXlsxSemanticColorOrigin, setXlsxUnderlineChild, xlsxGradientFillFallbackColor, setXlsxColorChild, createXlsxColorResolver, resolveXlsxColor, setXlsxBorderLine, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, defaultXlsxBorder, prepareXlsxSemanticPalette, importedSheetProtectionAuthority, defaultSpreadsheetColorScaleThresholds, xlsxRgbColor, writeXlsxAlignment, xlsxGradientFillKey, applyXlsxSemanticColorOrigin, spreadsheetConditionalComparisonNeedsUpperValue, sheetHasProtectionState, xlsxWorksheetCellEntries, isSpreadsheetConditionalIconSetName, setXlsxValueChild, defaultXlsxFill, spreadsheetConditionalThresholdsEqual, spreadsheetConditionalIconSetCount } from "./9333.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, readXlsxWorksheetCharts, createXlsxFormulaCell, patchXlsxWorksheetDrawings, readXlsxWorksheetImages, writeXlsxProtection, xlsxWorksheetChartsToSheet, readXlsxFormulaFeaturesFromPackage, emptySpreadsheetWorksheetCompatibilitySummary, createSpreadsheetFormulaMetadata, createXlsxErrorCell, xlsxWorksheetImagesToSheet, readXlsxProtection, patchXlsxFormulaFeatures, patchXlsxPivotTables, writeXlsxPageSetup, XlsxCellProtectionWriter, applyImportedXlsxPivotTables, readXlsxPageSetup } from "./4166.js";
 import { WorkFileImportController, materializeWorkFileSource } from "./9356.js";
@@ -2191,6 +2191,7 @@ function work_xlsx_page_breaks_booleanAttribute(element, name) {
 }
 const IMPORTED_WORKSHEET_ELEMENTS = new Set([
     'pane',
+    'autoFilter',
     'dataValidation',
     'conditionalFormatting',
     'sheetProtection',
@@ -2218,7 +2219,7 @@ const DIAGNOSTIC_WORKSHEET_ELEMENTS = new Set([
     'rowBreaks',
     'colBreaks'
 ]);
-const WORKSHEET_SCAN_PATTERN = /<(?:[A-Za-z_][\w.-]*:)?(?:(cols|f|pane|dataValidation|conditionalFormatting|sheetProtection|protectedRange|rowBreaks|colBreaks|pageSetup|pageMargins|printOptions|headerFooter|pageSetUpPr|drawing|tableParts)(?=[\s/>])|(row)(?=[\s/>])[^>]*\s(?:collapsed|customFormat|customHeight|hidden|ht|outlineLevel|thickBot|thickTop)\s*=|(c)(?=[\s/>])[^>]*\ss\s*=|(r)(?=[\s/>]))/g;
+const WORKSHEET_SCAN_PATTERN = /<(?:[A-Za-z_][\w.-]*:)?(?:(cols|f|pane|autoFilter|dataValidation|conditionalFormatting|sheetProtection|protectedRange|rowBreaks|colBreaks|pageSetup|pageMargins|printOptions|headerFooter|pageSetUpPr|drawing|tableParts)(?=[\s/>])|(row)(?=[\s/>])[^>]*\s(?:collapsed|customFormat|customHeight|hidden|ht|outlineLevel|thickBot|thickTop)\s*=|(c)(?=[\s/>])[^>]*\ss\s*=|(r)(?=[\s/>]))/g;
 function scanXlsxWorksheetXml(source) {
     let hasDirectCellStyles = false;
     let hasDiagnosticFeatures = false;
@@ -2395,6 +2396,9 @@ const OOXML_DYNAMIC_FILTERS = new Map([
 function readXlsxTableFilters(table, width) {
     const autoFilter = directChild(table.documentElement, 'autoFilter');
     if (!autoFilter) return [];
+    return readXlsxAutoFilterColumns(autoFilter, width);
+}
+function readXlsxAutoFilterColumns(autoFilter, width) {
     const result = [];
     const observed = new Set();
     for (const column of directChildren(autoFilter, 'filterColumn')){
@@ -2413,8 +2417,11 @@ function readXlsxTableFilters(table, width) {
 }
 function xlsxTableAutoFilterXml(filters, rangeReference, totalsRow) {
     const filterRange = totalsRow ? tableRangeWithoutFinalRow(rangeReference) : rangeReference;
+    return xlsxAutoFilterXml(filters, filterRange);
+}
+function xlsxAutoFilterXml(filters, rangeReference) {
     const columns = filters.slice().sort((left, right)=>left.column - right.column).map((filter)=>`<filterColumn colId="${filter.column}">${criteriaXml(filter.criteria)}</filterColumn>`).join('');
-    return `<autoFilter ref="${escapeXml(filterRange)}">${columns}</autoFilter>`;
+    return `<autoFilter ref="${escapeXml(rangeReference)}">${columns}</autoFilter>`;
 }
 function parseFilterCriteria(column) {
     const filters = directChild(column, 'filters');
@@ -2461,6 +2468,16 @@ function parseFilterCriteria(column) {
                 lower: first.value,
                 upper: second.value
             };
+            const firstCondition = customFilterCondition(first);
+            const secondCondition = customFilterCondition(second);
+            if (firstCondition && secondCondition) return {
+                type: 'compound',
+                conjunction: conjunction ? 'and' : 'or',
+                conditions: [
+                    firstCondition,
+                    secondCondition
+                ]
+            };
         }
     }
     const top = directChild(column, 'top10');
@@ -2498,6 +2515,9 @@ function singleCustomFilter(item) {
     if ('notEqual' === item.operator && '' === item.value) return {
         type: 'non-blanks'
     };
+    return customFilterCondition(item);
+}
+function customFilterCondition(item) {
     if ('equal' === item.operator) {
         const wildcard = wildcardCriterion(item.value);
         return wildcard ?? {
@@ -2511,10 +2531,22 @@ function singleCustomFilter(item) {
             type: 'not-equals',
             value: unescapeWildcards(item.value)
         };
-        return 'contains' === wildcard.type ? {
+        if ('contains' === wildcard.type) return {
             type: 'does-not-contain',
             value: wildcard.value
-        } : null;
+        };
+        if ('begins-with' === wildcard.type) return {
+            type: 'does-not-begin-with',
+            value: wildcard.value
+        };
+        if ('matches-wildcard' === wildcard.type) return {
+            type: 'does-not-match-wildcard',
+            value: wildcard.value
+        };
+        return {
+            type: 'does-not-end-with',
+            value: wildcard.value
+        };
     }
     const types = {
         greaterThan: 'greater-than',
@@ -2531,19 +2563,25 @@ function singleCustomFilter(item) {
 function wildcardCriterion(source) {
     const starts = source.startsWith('*');
     const ends = unescapedFinalAsterisk(source);
-    if (!starts && !ends) return null;
-    const value = unescapeWildcards(source.slice(starts ? 1 : 0, ends ? -1 : void 0));
-    if (starts && ends) return {
-        type: 'contains',
-        value
-    };
-    return starts ? {
-        type: 'ends-with',
-        value
-    } : {
-        type: 'begins-with',
-        value
-    };
+    const inner = source.slice(starts ? 1 : 0, ends ? -1 : void 0);
+    if ((starts || ends) && inner.length > 0 && !workSpreadsheetHasUnescapedWildcard(inner)) {
+        const value = unescapeWildcards(inner);
+        if (starts && ends) return {
+            type: 'contains',
+            value
+        };
+        return starts ? {
+            type: 'ends-with',
+            value
+        } : {
+            type: 'begins-with',
+            value
+        };
+    }
+    return workSpreadsheetHasUnescapedWildcard(source) ? {
+        type: 'matches-wildcard',
+        value: source
+    } : null;
 }
 function criteriaXml(criteria) {
     if ('values' === criteria.type) {
@@ -2554,6 +2592,11 @@ function criteriaXml(criteria) {
     if ('non-blanks' === criteria.type) return customFilterXml('notEqual', '');
     if ('between' === criteria.type) return customFilterPairXml(true, 'greaterThanOrEqual', criteria.lower, 'lessThanOrEqual', criteria.upper);
     if ('not-between' === criteria.type) return customFilterPairXml(false, 'lessThan', criteria.lower, 'greaterThan', criteria.upper);
+    if ('compound' === criteria.type) {
+        const [firstOperator, firstValue] = customFilterParts(criteria.conditions[0]);
+        const [secondOperator, secondValue] = customFilterParts(criteria.conditions[1]);
+        return customFilterPairXml('and' === criteria.conjunction, firstOperator, firstValue, secondOperator, secondValue);
+    }
     if ('top' === criteria.type) return topXml(true, false, criteria.count);
     if ('top-percent' === criteria.type) return topXml(true, true, criteria.percent);
     if ('bottom' === criteria.type) return topXml(false, false, criteria.count);
@@ -2562,22 +2605,48 @@ function criteriaXml(criteria) {
         const kind = OOXML_DYNAMIC_FILTERS.get(criteria.kind);
         return kind ? `<dynamicFilter type="${kind}"/>` : '';
     }
-    const operator = comparisonOperator(criteria.type);
-    const value = 'contains' === criteria.type ? `*${escapeWildcards(criteria.value)}*` : 'does-not-contain' === criteria.type ? `*${escapeWildcards(criteria.value)}*` : 'begins-with' === criteria.type ? `${escapeWildcards(criteria.value)}*` : 'ends-with' === criteria.type ? `*${escapeWildcards(criteria.value)}` : 'equals' === criteria.type || 'not-equals' === criteria.type ? escapeWildcards(criteria.value) : criteria.value;
+    const [operator, value] = customFilterParts(criteria);
     return customFilterXml(operator, value);
 }
+function customFilterParts(criteria) {
+    const operator = comparisonOperator(criteria.type);
+    if ('contains' === criteria.type || 'does-not-contain' === criteria.type) return [
+        operator,
+        `*${escapeWildcards(criteria.value)}*`
+    ];
+    if ('begins-with' === criteria.type || 'does-not-begin-with' === criteria.type) return [
+        operator,
+        `${escapeWildcards(criteria.value)}*`
+    ];
+    if ('ends-with' === criteria.type || 'does-not-end-with' === criteria.type) return [
+        operator,
+        `*${escapeWildcards(criteria.value)}`
+    ];
+    if ('matches-wildcard' === criteria.type || 'does-not-match-wildcard' === criteria.type) return [
+        operator,
+        criteria.value
+    ];
+    return [
+        operator,
+        'equals' === criteria.type || 'not-equals' === criteria.type ? escapeWildcards(criteria.value) : criteria.value
+    ];
+}
 function comparisonOperator(type) {
     const operators = {
         'begins-with': 'equal',
         contains: 'equal',
+        'does-not-begin-with': 'notEqual',
         'does-not-contain': 'notEqual',
+        'does-not-end-with': 'notEqual',
+        'does-not-match-wildcard': 'notEqual',
         'ends-with': 'equal',
         equals: 'equal',
         'greater-than': 'greaterThan',
         'greater-than-or-equal': 'greaterThanOrEqual',
         'less-than': 'lessThan',
         'less-than-or-equal': 'lessThanOrEqual',
-        'not-equals': 'notEqual'
+        'not-equals': 'notEqual',
+        'matches-wildcard': 'equal'
     };
     return operators[type];
 }
@@ -2951,6 +3020,7 @@ async function readXlsxSheetFeaturesFromPackage(archive, worksheetScans) {
         }
         const document1 = parseXml(source, partPath);
         features.set(sheetName, {
+            autoFilterCriteria: readWorksheetAutoFilterCriteria(document1),
             directCellStyles: readXlsxDirectCellStyles(document1, styles, theme),
             frozen: parseFrozenPane(document1) ?? void 0,
             validations: parseDataValidations(document1, uses1904DateSystem),
@@ -2971,6 +3041,7 @@ function xlsxWorksheetMayReferenceSharedStrings(source) {
 }
 function emptyXlsxSheetFeatures() {
     return {
+        autoFilterCriteria: [],
         directCellStyles: [],
         validations: [],
         conditionalFormats: [],
@@ -2997,7 +3068,7 @@ async function patchXlsxSheetFeatures(buffer, content) {
             pageSetup.sheetId,
             pageSetup
         ]));
-    if (!sheets.some((sheet)=>sheet.frozen || Object.keys(sheet.dataVerification ?? {}).length || sheet.dataValidationRanges?.length || sheet.luckysheet_conditionformat_save?.length || sheetHasXlsxRichTextCells(sheet) || sheetHasDirectCellStyles(sheet) || sheetHasProtectionState(sheet) || Boolean(sheet.id && (pageBreaksBySheetId.get(sheet.id)?.rows?.length ?? 0) + (pageBreaksBySheetId.get(sheet.id)?.columns?.length ?? 0)) || Boolean(sheet.id && pageSetupsBySheetId.has(sheet.id)))) return buffer;
+    if (!sheets.some((sheet)=>sheet.frozen || Object.keys(sheet.dataVerification ?? {}).length || sheet.dataValidationRanges?.length || sheet.luckysheet_conditionformat_save?.length || workSpreadsheetAutoFilterCriteriaEntries(sheet).length || sheetHasXlsxRichTextCells(sheet) || sheetHasDirectCellStyles(sheet) || sheetHasProtectionState(sheet) || Boolean(sheet.id && (pageBreaksBySheetId.get(sheet.id)?.rows?.length ?? 0) + (pageBreaksBySheetId.get(sheet.id)?.columns?.length ?? 0)) || Boolean(sheet.id && pageSetupsBySheetId.has(sheet.id)))) return buffer;
     const archive = await work_ooxml_package_OoxmlPackage.load(buffer);
     const worksheetParts = await readWorksheetParts(archive);
     const zip = await jszip.loadAsync(buffer);
@@ -3010,7 +3081,7 @@ async function patchXlsxSheetFeatures(buffer, content) {
     for (const sheet of sheets){
         const pageBreaks = sheet.id ? pageBreaksBySheetId.get(sheet.id) : void 0;
         const pageSetup = sheet.id ? pageSetupsBySheetId.get(sheet.id) : void 0;
-        if (!sheet.frozen && !Object.keys(sheet.dataVerification ?? {}).length && !sheet.dataValidationRanges?.length && !sheet.luckysheet_conditionformat_save?.length && !sheetHasXlsxRichTextCells(sheet) && !sheetHasDirectCellStyles(sheet) && !sheetHasProtectionState(sheet) && !(pageBreaks?.rows?.length || pageBreaks?.columns?.length) && !pageSetup) continue;
+        if (!sheet.frozen && !Object.keys(sheet.dataVerification ?? {}).length && !sheet.dataValidationRanges?.length && !sheet.luckysheet_conditionformat_save?.length && !workSpreadsheetAutoFilterCriteriaEntries(sheet).length && !sheetHasXlsxRichTextCells(sheet) && !sheetHasDirectCellStyles(sheet) && !sheetHasProtectionState(sheet) && !(pageBreaks?.rows?.length || pageBreaks?.columns?.length) && !pageSetup) continue;
         const exportedName = sheet.name.slice(0, 31) || '工作表';
         const partPath = worksheetParts.get(exportedName);
         const entry = partPath ? zip.file(partPath) : null;
@@ -3019,6 +3090,7 @@ async function patchXlsxSheetFeatures(buffer, content) {
         if (sheet.frozen) writeFrozenPane(document1, sheet.frozen);
         writeDataValidations(document1, sheet.dataVerification, sheet.dataValidationRanges, new Set((content.namedRanges ?? []).filter((namedRange)=>!namedRange.scopeSheetId || namedRange.scopeSheetId === sheet.id).map((namedRange)=>namedRange.name.trim().toLocaleLowerCase())));
         writeXlsxConditionalFormats(document1, sheet.luckysheet_conditionformat_save, differentialFormats);
+        writeWorksheetAutoFilterCriteria(document1, workSpreadsheetAutoFilterCriteriaEntries(sheet));
         if (directCellStyles) writeXlsxDirectCellStyles(document1, sheet, directCellStyles);
         writeXlsxRichTextCells(document1, sheet, semanticPalette?.palette);
         writeXlsxProtection(document1, sheet, cellProtection);
@@ -3033,6 +3105,20 @@ async function patchXlsxSheetFeatures(buffer, content) {
         compression: 'DEFLATE'
     });
 }
+function readWorksheetAutoFilterCriteria(document1) {
+    const autoFilter = directChild(document1.documentElement, 'autoFilter');
+    return autoFilter ? readXlsxAutoFilterColumns(autoFilter, 16384) : [];
+}
+function writeWorksheetAutoFilterCriteria(document1, filters) {
+    if (!filters.length) return;
+    const current = directChild(document1.documentElement, 'autoFilter');
+    const reference = current ? work_ooxml_package_attribute(current, 'ref') : null;
+    if (!current || !reference) return;
+    const namespace = document1.documentElement.namespaceURI;
+    const source = xlsxAutoFilterXml(filters, reference).replace('<autoFilter ', `<autoFilter xmlns="${namespace ?? ''}" `);
+    const replacement = document1.importNode(parseXml(source, 'worksheet AutoFilter').documentElement, true);
+    current.parentNode?.replaceChild(replacement, current);
+}
 function spreadsheetXlsxSemanticColors(content) {
     const colors = [];
     for (const sheet of content.sheets){
@@ -4194,7 +4280,7 @@ async function importWorkSpreadsheetFile(file, extension, context) {
         const filterSelect = XLSX ? fortuneSheetFilter(worksheet, XLSX) : void 0;
         const dataVerification = XLSX ? fortuneSheetDataVerification(features?.validations ?? [], rowCount, columnCount, XLSX) : {};
         const dataValidationRanges = XLSX ? fortuneSheetDataValidationRanges(features?.validations ?? [], rowCount, columnCount, XLSX) : [];
-        sheets.push({
+        sheets.push(workSpreadsheetSheetWithImportedAutoFilterCriteria({
             id,
             name,
             order: index,
@@ -4215,7 +4301,7 @@ async function importWorkSpreadsheetFile(file, extension, context) {
             charts: features?.charts.length ? xlsxWorksheetChartsToSheet(features.charts, config) : void 0,
             tables: features?.tables.length ? features.tables : void 0,
             formulaMetadata
-        });
+        }, features?.autoFilterCriteria ?? []));
         await context.controller.checkpoint('parsing', sheetProgressStart + sheetProgressSize);
     }
     const workbookMetadata = importXlsxDefinedNames(workbook, sheets);
@@ -5293,12 +5379,12 @@ function work_pdf_export_safeFileName(value) {
 }
 var core_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5416.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
 export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
 export { createOfficeDocumentCollaborationBinding, forgetSourceBlob, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration, readSourceBlob, registerSourceBlob } from "./4174.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./3266.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 { WORK_DOCUMENT_SNAPSHOT_MEDIA_TYPE as DOCUMENT_SNAPSHOT_MEDIA_TYPE, WORK_DOCUMENT_SNAPSHOT_SCHEMA as DOCUMENT_SNAPSHOT_SCHEMA, WORK_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, WORK_DOCUMENT_SOURCE_MEDIA_TYPE as DOCUMENT_SOURCE_MEDIA_TYPE, WORK_DOCUMENT_SOURCE_SCHEMA as DOCUMENT_SOURCE_SCHEMA, WORK_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, WORK_IMPORT_ACCEPT as OFFICE_FILE_ACCEPT, WORK_OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES as OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, WORK_OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES as OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, WORK_OFFICE_COLLABORATION_PRESENCE_FIELD as OFFICE_COLLABORATION_PRESENCE_FIELD, applyWorkDocumentSource as applyDocumentSource, core_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION, createWorkArtifactBlob as createArtifactBlob, createWorkOfficeCollaborationPresence as createOfficeCollaborationPresence, createWorkOfficeCollaborationTransportBinding as createOfficeCollaborationTransportBinding, createWorkPdfCollaborationContent as createPdfCollaborationContent, decodeWorkDocumentSnapshot as decodeDocumentSnapshot, defaultPptxRuntimeUrl, encodeWorkDocumentSnapshot as encodeDocumentSnapshot, exportWorkArtifact as downloadArtifact, exportWorkArtifactPdf as downloadArtifactPdf, importWorkFile as importOfficeFile, projectWorkDocumentSource as projectDocumentSource, workArtifactExtension as artifactExtension, workArtifactExtension, workArtifactKindLabel as artifactKindLabel, workArtifactKindLabel, workKindForFile as officeKindForFile, workPdfPagesForExport as pdfPagesForExport };

package/dist/index.js

@@ -2,6 +2,7 @@ var src_DOCUMENT_SNAPSHOT_VERSION = 1;
 var src_DOCUMENT_SOURCE_VERSION = 1;
 var src_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5416.js";
 export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource } from "./core.js";
 export { DocumentEditor, MarkdownEditor, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
@@ -10,6 +11,5 @@ export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
 export { createOfficeDocumentCollaborationBinding, forgetSourceBlob, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration, readSourceBlob, registerSourceBlob } from "./4174.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./3266.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/features/work/editors/office-shortcuts.d.ts

@@ -1 +1,2 @@
+export declare function isOfficeCompositionKeyboardEvent(event: Pick<KeyboardEvent, 'isComposing' | 'key' | 'keyCode'>): boolean;
 export declare function isOfficeShortcutBlocked(target: EventTarget | null): boolean;

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

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

@@ -0,0 +1,27 @@
+import type { WorkSpreadsheetCustomFilterCondition, WorkSpreadsheetDynamicFilter, WorkSpreadsheetFilterCriteria } from '../work-types';
+export type SpreadsheetAutoFilterConditionType = WorkSpreadsheetCustomFilterCondition['type'] | WorkSpreadsheetDynamicFilter | 'between' | 'not-between' | 'top' | 'top-percent' | 'bottom' | 'bottom-percent' | 'blanks' | 'non-blanks';
+export declare const CONDITION_LABELS: Readonly<Record<SpreadsheetAutoFilterConditionType, string>>;
+export declare const TEXT_CONDITIONS: readonly SpreadsheetAutoFilterConditionType[];
+export declare const WILDCARD_CONDITIONS: readonly ["matches-wildcard", "does-not-match-wildcard"];
+export declare const NUMBER_COMPARISON_CONDITIONS: readonly ["greater-than", "greater-than-or-equal", "less-than", "less-than-or-equal"];
+export declare const NUMBER_CONDITIONS: readonly SpreadsheetAutoFilterConditionType[];
+export declare const RANK_CONDITIONS: readonly ["top", "top-percent", "bottom", "bottom-percent"];
+export declare const AVERAGE_CONDITIONS: readonly ["above-average", "below-average"];
+export declare const DATE_CONDITIONS: readonly ["today", "yesterday", "tomorrow", "this-week", "last-week", "next-week", "this-month", "last-month", "next-month", "this-quarter", "last-quarter", "next-quarter", "this-year", "last-year", "next-year", "year-to-date", "quarter-1", "quarter-2", "quarter-3", "quarter-4", "month-1", "month-2", "month-3", "month-4", "month-5", "month-6", "month-7", "month-8", "month-9", "month-10", "month-11", "month-12"];
+export declare const BLANK_CONDITIONS: readonly SpreadsheetAutoFilterConditionType[];
+export interface SpreadsheetAutoFilterConditionDraft {
+    conjunction: 'and' | 'or';
+    secondType: WorkSpreadsheetCustomFilterCondition['type'];
+    secondValue: string;
+    type: SpreadsheetAutoFilterConditionType;
+    upperValue: string;
+    useSecond: boolean;
+    value: string;
+}
+export declare function spreadsheetAutoFilterConditionDraft(criteria: WorkSpreadsheetFilterCriteria | null, numeric: boolean, date: boolean): SpreadsheetAutoFilterConditionDraft;
+export declare function spreadsheetAutoFilterConditionCriteria(draft: SpreadsheetAutoFilterConditionDraft): WorkSpreadsheetFilterCriteria | null;
+export declare function spreadsheetAutoFilterPrimaryConditionError(draft: SpreadsheetAutoFilterConditionDraft): string | null;
+export declare function spreadsheetAutoFilterValueError(type: SpreadsheetAutoFilterConditionType, value: string): string | null;
+export declare function spreadsheetAutoFilterCustomConditionType(value: string): value is WorkSpreadsheetCustomFilterCondition['type'];
+export declare function spreadsheetAutoFilterRankConditionType(value: string): value is (typeof RANK_CONDITIONS)[number];
+export declare function spreadsheetAutoFilterDynamicConditionType(value: string): value is WorkSpreadsheetDynamicFilter;

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

@@ -0,0 +1,17 @@
+import type { WorkSpreadsheetFilterCriteria } from '../work-types';
+export type { SpreadsheetAutoFilterConditionType } from './spreadsheet-auto-filter-condition-dialog-model';
+export interface SpreadsheetAutoFilterConditionDialogSource {
+    columnLabel: string;
+    criteria: WorkSpreadsheetFilterCriteria | null;
+    date: boolean;
+    hasActiveFilter: boolean;
+    numeric: boolean;
+    sheetName: string;
+}
+export declare function SpreadsheetAutoFilterConditionDialog({ source, restoreFocusTarget, onApply, onClear, onClose, }: {
+    source: SpreadsheetAutoFilterConditionDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (criteria: WorkSpreadsheetFilterCriteria) => boolean;
+    onClear: () => boolean;
+    onClose: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { WorkSpreadsheetSheet } from '../work-types';
+export declare const SPREADSHEET_AUTO_FILTER_MENU_ITEMS: string[];
+export declare function enhanceSpreadsheetAutoFilterSurface(container: HTMLElement, sheet: WorkSpreadsheetSheet | undefined, invoker: HTMLElement | null): HTMLElement | null;
+export declare function focusSpreadsheetAutoFilterMenu(container: HTMLElement): void;
+export declare function spreadsheetAutoFilterMenuFocusable(menu: HTMLElement): HTMLElement[];
+export declare function spreadsheetAutoFilterTrigger(target: EventTarget | null): HTMLElement | null;
+export declare function spreadsheetAutoFilterMenu(target: EventTarget | null): HTMLElement | null;
+export declare function spreadsheetAutoFilterConditionAction(target: EventTarget | null): HTMLElement | null;
+export declare function spreadsheetAutoFilterRankAction(target: EventTarget | null): HTMLElement | null;
+export declare function spreadsheetAutoFilterColumnLabel(sheet: WorkSpreadsheetSheet | undefined, row: number, column: number): string;

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

@@ -1,10 +1,22 @@
 import type { Selection } from '@fortune-sheet/core';
-import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
-export interface SpreadsheetAutoFilterRange {
-    row: [number, number];
-    column: [number, number];
+import type { WorkSpreadsheetFilterCriteria, WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
+import { type WorkSpreadsheetAutoFilterRange } from '../work-spreadsheet-auto-filter';
+import { type WorkSpreadsheetDynamicFilterContext } from '../work-spreadsheet-dynamic-filter';
+export type SpreadsheetAutoFilterRange = WorkSpreadsheetAutoFilterRange;
+export interface SpreadsheetAutoFilterTarget {
+    column: number;
+    filterRange: SpreadsheetAutoFilterRange;
+    sheetId: string;
+}
+export interface SpreadsheetAutoFilterCriteriaRequest extends SpreadsheetAutoFilterTarget {
+    criteria: WorkSpreadsheetFilterCriteria;
 }
 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;
+export declare function spreadsheetAutoFilterCriteria(sheet: WorkSpreadsheetSheet | undefined, column: number): WorkSpreadsheetFilterCriteria | null;
+export declare function spreadsheetAutoFilterColumnIsNumeric(sheet: WorkSpreadsheetSheet, range: SpreadsheetAutoFilterRange, column: number): boolean;
+export declare function spreadsheetAutoFilterColumnIsDate(sheet: WorkSpreadsheetSheet, range: SpreadsheetAutoFilterRange, column: number): boolean;
+export declare function applySpreadsheetAutoFilterCriteria(content: WorkSpreadsheetContent, sheetId: string, column: number, criteria: WorkSpreadsheetFilterCriteria, context?: WorkSpreadsheetDynamicFilterContext): WorkSpreadsheetContent | null;
+export declare function clearSpreadsheetAutoFilterCriteria(content: WorkSpreadsheetContent, sheetId: string, column: number): WorkSpreadsheetContent | null;

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

@@ -10,5 +10,6 @@ export declare function normalizeSpreadsheetCellRange(value: SpreadsheetCellRang
 export declare function parseSpreadsheetCellRange(value: unknown): SpreadsheetCellRange | null;
 export declare function subtractSpreadsheetCellRange(source: SpreadsheetCellRange, removed: SpreadsheetCellRange): SpreadsheetCellRange[];
 export declare function spreadsheetCellRangesIntersect(left: SpreadsheetCellRange, right: SpreadsheetCellRange): boolean;
+export declare function spreadsheetCellRangesEqual(left: SpreadsheetCellRangeInput, right: SpreadsheetCellRangeInput): boolean;
 export declare function spreadsheetCellRangeContains(range: SpreadsheetCellRange, row: number, column: number): boolean;
 export declare function spreadsheetCellRangeArea(range: SpreadsheetCellRange): number;

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

@@ -1091,6 +1091,15 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "sortAndFilter";
         };
     };
+    readonly customSort: {
+        readonly id: "data.customSort";
+        readonly label: "自定义排序";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "data";
+            readonly group: "sortAndFilter";
+        };
+    };
     readonly autoFilter: {
         readonly id: "data.autoFilter";
         readonly label: "自动筛选";

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

@@ -4,6 +4,7 @@ import type { SpreadsheetTextOrientationId } from '../work-spreadsheet-text-orie
 import type { WorkSpreadsheetContent } from '../work-types';
 import { type OfficeEditorCanCommands, type OfficeEditorExtension } from './office-editor-extension';
 import type { SpreadsheetAutoSumFunction } from './spreadsheet-auto-sum';
+import type { SpreadsheetAutoFilterCriteriaRequest, SpreadsheetAutoFilterTarget } from './spreadsheet-auto-filter';
 import type { SpreadsheetCellBorderFormat } from './spreadsheet-cell-border';
 import { type SpreadsheetCellClearMode } from './spreadsheet-cell-clear';
 import type { SpreadsheetCellFillDirection } from './spreadsheet-cell-fill';
@@ -24,6 +25,7 @@ import { type SpreadsheetDecimalPlacesDirection } from './spreadsheet-number-for
 import type { SpreadsheetPasteContent } from './spreadsheet-paste-special';
 import type { SpreadsheetRichTextToggleAttribute } from './spreadsheet-rich-text-selection-format';
 import { type SpreadsheetSheetMoveDirection } from './spreadsheet-sheet-model';
+import type { SpreadsheetSortDirection, SpreadsheetSortOpenRequest, SpreadsheetSortRequest } from './spreadsheet-sort';
 import type { SpreadsheetTableDesignPatch, SpreadsheetTableRequest, SpreadsheetTableTarget } from './spreadsheet-table';
 export interface SpreadsheetWorkbookCommandPort {
     autoFillCell: (copyRange: SpreadsheetCommandRange, applyRange: SpreadsheetCommandRange, direction: SpreadsheetCellFillDirection) => void;
@@ -78,7 +80,7 @@ export interface SpreadsheetSelectionRef {
 }
 export type SpreadsheetStructureAxis = 'row' | 'column';
 export type SpreadsheetStructureInsertPosition = 'before' | 'after';
-export type SpreadsheetSortDirection = 'ascending' | 'descending';
+export type { SpreadsheetSortDirection } from './spreadsheet-sort';
 export type SpreadsheetCalculationCommand = {
     scope: 'workbook';
 } | {
@@ -148,6 +150,11 @@ export interface SpreadsheetTableCommandPort {
     canOpen: boolean;
     open: (target: SpreadsheetTableTarget) => boolean;
 }
+export interface SpreadsheetSortCommandPort {
+    canApply: (request: SpreadsheetSortRequest, liveRange: SpreadsheetCommandRange) => boolean;
+    canOpen: boolean;
+    open: (request: SpreadsheetSortOpenRequest) => boolean;
+}
 export interface SpreadsheetNavigationCommandPort {
     canOpenFind: boolean;
     canOpenGoTo: boolean;
@@ -174,13 +181,16 @@ export interface SpreadsheetEditorCommands {
     adjustFontSize: (direction: SpreadsheetFontSizeDirection) => boolean;
     applyCellStyle: (preset: SpreadsheetCellStyleChoice) => boolean;
     applyCellFormat: (request: SpreadsheetCellFormatRequest) => boolean;
+    applyAutoFilterCriteria: (request: SpreadsheetAutoFilterCriteriaRequest) => boolean;
     applyDataValidation: (request: SpreadsheetDataValidationRequest) => boolean;
     applyAutoSum: (functionName: SpreadsheetAutoSumFunction) => boolean;
     applyFormatPainter: (target: SpreadsheetCommandSelection) => boolean;
     applyHyperlink: (request: SpreadsheetHyperlinkRequest) => boolean;
     applyTable: (request: SpreadsheetTableRequest) => boolean;
+    applyCustomSort: (request: SpreadsheetSortRequest) => boolean;
     cancelFormatPainter: () => boolean;
     clearSelectedCells: (mode?: SpreadsheetCellClearMode) => boolean;
+    clearAutoFilterCriteria: (target: SpreadsheetAutoFilterTarget) => boolean;
     copyCellFromAbove: (kind: SpreadsheetCopyFromAboveKind) => boolean;
     copySelection: () => boolean;
     cutSelection: () => boolean;
@@ -201,6 +211,7 @@ export interface SpreadsheetEditorCommands {
     openGoTo: () => boolean;
     openHyperlink: () => boolean;
     openPasteSpecial: () => boolean;
+    openCustomSort: () => boolean;
     openTable: () => boolean;
     pasteCells: (values: readonly (readonly unknown[])[]) => boolean;
     pasteSelection: () => boolean;
@@ -248,6 +259,7 @@ export interface SpreadsheetCommandContext {
     richTextFormat?: SpreadsheetRichTextFormatCommandPort | null;
     selection: SpreadsheetCommandSelection | null;
     selectionRef?: SpreadsheetSelectionRef;
+    sort: SpreadsheetSortCommandPort;
     table: SpreadsheetTableCommandPort;
     targetSheetGridSize?: SpreadsheetGridSize | null;
     targetSheetId: string;

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

@@ -0,0 +1,12 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellRange, type SpreadsheetCellRangeInput } from './spreadsheet-cell-range';
+/**
+ * Finds the bounded rectangular current region that contains a seed range.
+ * Dense and sparse worksheets share this reader so filter and sort commands do
+ * not derive different expansion boundaries from the same controlled sheet.
+ */
+export declare function spreadsheetCurrentRegion(sheet: WorkSpreadsheetSheet, seed: SpreadsheetCellRangeInput): SpreadsheetCellRange | null;
+export declare function spreadsheetRowHasContent(cellAt: (row: number, column: number) => Cell | null, row: number, startColumn: number, endColumn: number): boolean;
+export declare function spreadsheetCellHasContent(cell: Cell | null): boolean;
+export declare function spreadsheetSheetCellReader(sheet: WorkSpreadsheetSheet): (row: number, column: number) => Cell | null;

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

@@ -2,6 +2,7 @@ import type { WorkOfficeCollaborationSession } from '../../../collaboration/offi
 import type { WorkEditorAgentRequest } from '../work-agent-request';
 import type { WorkSpreadsheetContent } from '../work-types';
 import { type SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+import type { SpreadsheetSortCustomListStore } from './spreadsheet-sort-custom-list-store';
 import { type WorkOfficeFileAction } from './work-office-chrome';
 export interface SpreadsheetEditorProps {
     autoFocus?: boolean;
@@ -10,6 +11,7 @@ export interface SpreadsheetEditorProps {
     kernelWasmUrl?: string;
     preview: boolean;
     saveStatus?: string;
+    sortCustomListStore?: SpreadsheetSortCustomListStore;
     fileActions?: readonly WorkOfficeFileAction[];
     onChange: (content: WorkSpreadsheetContent) => void;
     onAgentRequest?: (request: WorkEditorAgentRequest) => void | Promise<void>;
@@ -19,4 +21,5 @@ export declare function focusSpreadsheetGrid(container: HTMLElement | null, { fo
     focusOrigin?: Element | null;
     forceInitial?: boolean;
 }): void;
+export declare function preserveSpreadsheetGridFocus(container: HTMLElement | null, target: EventTarget | null): void;
 export declare function spreadsheetCommandsWithGridFocus(commands: SpreadsheetEditorCommands, restoreFocus: () => void): SpreadsheetEditorCommands;