@a3s-lab/office 0.37.2 → 0.37.4

package/dist/5416.js

@@ -2756,6 +2756,33 @@ function workSpreadsheetAutoFilterManuallyHiddenRows(sheet) {
     }
     return manuallyHidden;
 }
+function workSpreadsheetAutoFilterOwnedRows(sheet) {
+    return filterHiddenRows(sheet.filter);
+}
+function workSpreadsheetFilterHiddenRows(sheet, range, column, criteria, context = {
+    now: new Date()
+}) {
+    const normalizedCriteria = normalizeWorkSpreadsheetFilterCriteria(criteria);
+    const normalizedRange = normalizedWorkSpreadsheetAutoFilterRange(range);
+    if (!normalizedCriteria || !normalizedRange || !columnInRange(normalizedRange, column)) return null;
+    return hiddenRowsForCriteria(sheet, normalizedRange, column, normalizedCriteria, context);
+}
+function workSpreadsheetSheetWithReappliedAutoFilterCriteria(sheet, criteriaSource, manuallyHiddenRows, context = {
+    now: new Date()
+}) {
+    const range = normalizedWorkSpreadsheetAutoFilterRange(sheet.filter_select);
+    if (!range) return sheet;
+    const entries = workSpreadsheetAutoFilterCriteriaEntries(criteriaSource);
+    const filter = {};
+    for (const entry of entries){
+        const column = range.column[0] + entry.column;
+        const criteria = normalizeWorkSpreadsheetFilterCriteria(entry.criteria);
+        if (!criteria || !columnInRange(range, column)) continue;
+        const rowhidden = hiddenRowsForCriteria(sheet, range, column, criteria, context);
+        if (rowhidden) filter[String(entry.column)] = filterColumnState(range, column, criteria, rowhidden);
+    }
+    return sheetWithFilterState(sheet, filter, manuallyHiddenRows);
+}
 function workSpreadsheetSheetWithImportedAutoFilterCriteria(sheet, entries, context = {
     now: new Date()
 }) {
@@ -4047,4 +4074,4 @@ function normalizeStoredSpreadsheetSortCustomLists(input) {
 function spreadsheet_sort_custom_list_store_isRecord(value) {
     return Boolean(value && 'object' == typeof value && !Array.isArray(value));
 }
-export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, SPREADSHEET_TABLE_TOTALS_FUNCTIONS, activeXlsxNativeFill, activeXlsxSemanticColorOrigin, applyImportedXlsxRichText, boundedSpreadsheetDataValidationText, coalesceXlsxRichTextRuns, createSpreadsheetSortCustomList, createWorkOfficeSpreadsheetCollaborationBinding as createOfficeSpreadsheetCollaborationBinding, createXlsxRichTextReadContext, deleteXlsxNativeFills, directXlsxAlignment, directXlsxFontStyle, fillSpreadsheetTableCalculatedColumns, hasXlsxDirectFontStyle, initializeWorkOfficeSpreadsheetCollaboration as initializeOfficeSpreadsheetCollaboration, isHighSurrogate, isLowSurrogate, isSpreadsheetTextOrientationId, isSpreadsheetUnderlineStyle, mergeSpreadsheetSortCustomLists, normalizeSpreadsheetDataValidationErrorStyle, normalizeSpreadsheetDateValidationBoundary, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, normalizeSpreadsheetTableTotalsLabel, normalizeStoredSpreadsheetSortCustomLists, normalizeWorkSpreadsheetFilterCriteria, normalizeXlsxRichTextCell, normalizeXlsxRichTextColor, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextRun, normalizedWorkSpreadsheetAutoFilterRange, parseSpreadsheetSortCustomList, patchSpreadsheetRichTextFontRuns, readWorkOfficeSpreadsheetCollaboration as readOfficeSpreadsheetCollaboration, readXlsxRichTextCells, reconcileSpreadsheetTableCalculatedColumns, reconcileSpreadsheetTableTotalsColumns, replaceWorkOfficeSpreadsheetCollaboration as replaceOfficeSpreadsheetCollaboration, sameXlsxRichTextRunStyle, sheetHasXlsxRichTextCells, spreadsheetCellValueWithDiagonalBorder, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, spreadsheetExplicitTextOrientationFromCell, spreadsheetSortCustomListMatchKey, spreadsheetSortCustomListsEqual, spreadsheetTableTotalsColumnPatch, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetTableTotalsFunctionLabel, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTableTotalsRowHasContent, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, spreadsheetTextOrientationFromAngle, spreadsheetTextOrientationFromCell, spreadsheetTextOrientationFromChoice, spreadsheetTextOrientationFromXlsx, spreadsheetUnderlineCellValue, spreadsheetUnderlineCellValueFromSheetJs, spreadsheetUnderlineCellValueFromXlsx, spreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell, synchronizeSpreadsheetTableTotalsRow, validXlsxRichText, validateSpreadsheetSortCustomList, withDefaultSpreadsheetTableTotalsLabel, workSpreadsheetAutoFilterCriteria, workSpreadsheetAutoFilterCriteriaEntries, workSpreadsheetAutoFilterManuallyHiddenRows, workSpreadsheetCellIsDate, workSpreadsheetFilterTextCharacters, workSpreadsheetHasUnescapedWildcard, workSpreadsheetSheetWithAutoFilterCriteria, workSpreadsheetSheetWithImportedAutoFilterCriteria, workSpreadsheetSheetWithoutAutoFilterCriteria, writeXlsxRichTextCells, xlsxAlignmentMatches, xlsxBooleanAttribute, xlsxBorderLineMatches, xlsxColorMatches, xlsxNativeFillCellKeys, xlsxNativeFillKey, xlsxNativeFillSemanticColors, xlsxRichTextCellText, xlsxRichTextStyleOrigins, xlsxStyleCollectionIndex, xlsxToggleEnabled, xlsxUnderlineStyle };
+export { DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY, LocalStorageSpreadsheetSortCustomListStore, SPREADSHEET_TABLE_TOTALS_FUNCTIONS, activeXlsxNativeFill, activeXlsxSemanticColorOrigin, applyImportedXlsxRichText, boundedSpreadsheetDataValidationText, coalesceXlsxRichTextRuns, createSpreadsheetSortCustomList, createWorkOfficeSpreadsheetCollaborationBinding as createOfficeSpreadsheetCollaborationBinding, createXlsxRichTextReadContext, deleteXlsxNativeFills, directXlsxAlignment, directXlsxFontStyle, fillSpreadsheetTableCalculatedColumns, hasXlsxDirectFontStyle, initializeWorkOfficeSpreadsheetCollaboration as initializeOfficeSpreadsheetCollaboration, isHighSurrogate, isLowSurrogate, isSpreadsheetTextOrientationId, isSpreadsheetUnderlineStyle, mergeSpreadsheetSortCustomLists, normalizeSpreadsheetDataValidationErrorStyle, normalizeSpreadsheetDateValidationBoundary, normalizeSpreadsheetTableCalculatedFormula, normalizeSpreadsheetTableTotalsFormula, normalizeSpreadsheetTableTotalsLabel, normalizeStoredSpreadsheetSortCustomLists, normalizeWorkSpreadsheetFilterCriteria, normalizeXlsxRichTextCell, normalizeXlsxRichTextColor, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextRun, normalizedWorkSpreadsheetAutoFilterRange, parseSpreadsheetSortCustomList, patchSpreadsheetRichTextFontRuns, readWorkOfficeSpreadsheetCollaboration as readOfficeSpreadsheetCollaboration, readXlsxRichTextCells, reconcileSpreadsheetTableCalculatedColumns, reconcileSpreadsheetTableTotalsColumns, replaceWorkOfficeSpreadsheetCollaboration as replaceOfficeSpreadsheetCollaboration, sameXlsxRichTextRunStyle, sheetHasXlsxRichTextCells, spreadsheetCellValueWithDiagonalBorder, spreadsheetDateValidationFormula, spreadsheetDiagonalBorderFromCellValue, spreadsheetExplicitTextOrientationFromCell, spreadsheetSortCustomListMatchKey, spreadsheetSortCustomListsEqual, spreadsheetTableTotalsColumnPatch, spreadsheetTableTotalsFunctionFromOoxml, spreadsheetTableTotalsFunctionLabel, spreadsheetTableTotalsFunctionToOoxml, spreadsheetTableTotalsRowHasContent, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, spreadsheetTextOrientationFromAngle, spreadsheetTextOrientationFromCell, spreadsheetTextOrientationFromChoice, spreadsheetTextOrientationFromXlsx, spreadsheetUnderlineCellValue, spreadsheetUnderlineCellValueFromSheetJs, spreadsheetUnderlineCellValueFromXlsx, spreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell, synchronizeSpreadsheetTableTotalsRow, validXlsxRichText, validateSpreadsheetSortCustomList, withDefaultSpreadsheetTableTotalsLabel, workSpreadsheetAutoFilterCriteria, workSpreadsheetAutoFilterCriteriaEntries, workSpreadsheetAutoFilterManuallyHiddenRows, workSpreadsheetAutoFilterOwnedRows, workSpreadsheetCellIsDate, workSpreadsheetFilterHiddenRows, workSpreadsheetFilterTextCharacters, workSpreadsheetHasUnescapedWildcard, workSpreadsheetSheetWithAutoFilterCriteria, workSpreadsheetSheetWithImportedAutoFilterCriteria, workSpreadsheetSheetWithReappliedAutoFilterCriteria, workSpreadsheetSheetWithoutAutoFilterCriteria, writeXlsxRichTextCells, xlsxAlignmentMatches, xlsxBooleanAttribute, xlsxBorderLineMatches, xlsxColorMatches, xlsxNativeFillCellKeys, xlsxNativeFillKey, xlsxNativeFillSemanticColors, xlsxRichTextCellText, xlsxRichTextStyleOrigins, xlsxStyleCollectionIndex, xlsxToggleEnabled, xlsxUnderlineStyle };

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

@@ -0,0 +1,6 @@
+import type { Op } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
+import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
+export declare function reconcileSpreadsheetFiltersAfterFortune(sheets: WorkSpreadsheetContent['sheets'], sourceSheets: WorkSpreadsheetContent['sheets'], operations?: readonly Op[]): WorkSpreadsheetContent['sheets'];
+export declare function reconcileSpreadsheetFiltersAfterSort(sheet: WorkSpreadsheetSheet, source: WorkSpreadsheetSheet, range: SpreadsheetCellRange, sourceIndexes: readonly number[]): WorkSpreadsheetSheet | null;
+export declare function spreadsheetFilterReconciliationIsBounded(sheet: WorkSpreadsheetSheet): boolean;

package/dist/internal/features/work/editors/spreadsheet-sort-custom-list-manager.d.ts

@@ -0,0 +1,15 @@
+import { type SpreadsheetSortCustomList } from './spreadsheet-sort-custom-list';
+export interface SpreadsheetSortCustomListManagementChange {
+    next: readonly string[] | null;
+    previous: readonly string[];
+}
+export interface SpreadsheetSortCustomListManagementResult {
+    changes: readonly SpreadsheetSortCustomListManagementChange[];
+    lists: readonly (readonly string[])[];
+}
+export declare function SpreadsheetSortCustomListManagerDialog({ customLists, restoreFocusTarget, onApply, onClose, }: {
+    customLists: readonly SpreadsheetSortCustomList[];
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetSortCustomListManagementResult) => void;
+    onClose: () => void;
+}): import("react").JSX.Element;

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

@@ -1,9 +1,10 @@
 import { type SpreadsheetSortDialogSource, type SpreadsheetSortDialogValue } from './spreadsheet-sort';
 import { type SpreadsheetSortCustomList } from './spreadsheet-sort-custom-list';
-export declare function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRememberCustomList, onClose, }: {
+export declare function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRememberCustomList, onUpdateCustomLists, onClose, }: {
     source: SpreadsheetSortDialogSource;
     restoreFocusTarget: () => HTMLElement | null;
     onApply: (value: SpreadsheetSortDialogValue) => boolean;
-    onRememberCustomList?: (list: SpreadsheetSortCustomList) => SpreadsheetSortCustomList | void;
+    onRememberCustomList?: (list: SpreadsheetSortCustomList) => SpreadsheetSortCustomList | undefined;
+    onUpdateCustomLists?: (lists: readonly (readonly string[])[]) => readonly SpreadsheetSortCustomList[] | undefined;
     onClose: () => void;
 }): import("react").JSX.Element;

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

@@ -1,6 +1,7 @@
 import type { SpreadsheetSortOptions } from './spreadsheet-sort';
-export declare function SpreadsheetSortOptionsDialog({ value, restoreFocusTarget, onApply, onClose, }: {
+export declare function SpreadsheetSortOptionsDialog({ value, orientationLocked, restoreFocusTarget, onApply, onClose, }: {
     value: SpreadsheetSortOptions;
+    orientationLocked?: boolean;
     restoreFocusTarget: () => HTMLElement | null;
     onApply: (value: SpreadsheetSortOptions) => void;
     onClose: () => void;

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

@@ -55,10 +55,24 @@ export interface SpreadsheetSortTarget {
     activeColumn: number;
     activeRow: number;
     range: SpreadsheetCellRange;
+    scope?: SpreadsheetSortOwnedScope;
+}
+export type SpreadsheetSortOwnedScope = {
+    hasHeader: true;
+    kind: 'auto-filter';
+} | {
+    hasHeader: boolean;
+    kind: 'table';
+    tableId: string;
+};
+export interface SpreadsheetSortOwnedRange {
+    range: SpreadsheetCellRange;
+    scope: SpreadsheetSortOwnedScope;
 }
 export interface SpreadsheetSortRangeCandidate {
     available: boolean;
     range: SpreadsheetCellRange;
+    scope?: SpreadsheetSortOwnedScope;
 }
 export type SpreadsheetSortIntent = {
     type: 'custom';
@@ -83,15 +97,18 @@ export interface SpreadsheetSortRangeDialogSource {
     canSortExpandedRange: boolean;
     canSortSelection: boolean;
     expandedRangeReference: string;
+    ownedScope?: SpreadsheetSortOwnedScope;
     selectedRangeReference: string;
     sheetName: string;
 }
 export type SpreadsheetSortRequest = Omit<SpreadsheetSortDialogValue, keyof SpreadsheetSortTextOptions> & Partial<SpreadsheetSortTextOptions> & {
     range: SpreadsheetCellRange;
+    scope?: SpreadsheetSortOwnedScope;
     sheetId: string;
 };
 export interface SpreadsheetSortNormalizedRequest extends SpreadsheetSortDialogValue {
     range: SpreadsheetCellRange;
+    scope?: SpreadsheetSortOwnedScope;
     sheetId: string;
 }
 export interface SpreadsheetSortField {
@@ -106,11 +123,12 @@ export interface SpreadsheetSortDialogSource {
     range: SpreadsheetCellRange;
     rangeReference: string;
     rows: SpreadsheetSortField[];
+    scope?: SpreadsheetSortOwnedScope;
     sheetId: string;
     sheetName: string;
     value: SpreadsheetSortDialogValue;
 }
-export type SpreadsheetSortErrorCode = 'column-out-of-range' | 'duplicate-key' | 'formula-reference-out-of-range' | 'invalid-appearance' | 'invalid-case-sensitivity' | 'invalid-custom-list' | 'invalid-direction' | 'invalid-header' | 'invalid-matrix' | 'invalid-orientation' | 'invalid-range' | 'invalid-text-method' | 'missing-key' | 'not-enough-columns' | 'not-enough-rows' | 'range-too-large' | 'row-out-of-range' | 'too-many-keys' | 'unsupported-text-method' | 'unsupported-linked-cell';
+export type SpreadsheetSortErrorCode = 'column-out-of-range' | 'duplicate-key' | 'formula-reference-out-of-range' | 'invalid-appearance' | 'invalid-case-sensitivity' | 'invalid-custom-list' | 'invalid-direction' | 'invalid-header' | 'invalid-matrix' | 'invalid-orientation' | 'invalid-range' | 'invalid-scope' | 'invalid-text-method' | 'missing-key' | 'not-enough-columns' | 'not-enough-rows' | 'range-too-large' | 'row-out-of-range' | 'too-many-keys' | 'unsupported-text-method' | 'unsupported-linked-cell';
 export type SpreadsheetSortValidationResult = {
     ok: true;
     request: SpreadsheetSortNormalizedRequest;
@@ -122,6 +140,7 @@ export type SpreadsheetSortValidationResult = {
 export type SpreadsheetSortResult = {
     ok: true;
     rows: (Cell | null)[][];
+    sourceIndexes: number[];
 } | {
     code: SpreadsheetSortErrorCode;
     message: string;
@@ -130,6 +149,9 @@ export type SpreadsheetSortResult = {
 export declare function createSpreadsheetSortRangePlan(sheet: WorkSpreadsheetSheet, selectedRange: SpreadsheetCellRange): SpreadsheetSortRangePlan | null;
 export declare function createSpreadsheetSortRangeDialogSource(sheetName: string, request: SpreadsheetSortOpenRequest): SpreadsheetSortRangeDialogSource | null;
 export declare function createSpreadsheetSortDialogSource(sheetId: string, sheetName: string, target: SpreadsheetSortTarget, rows: readonly (readonly (Cell | null)[])[], customLists?: readonly SpreadsheetSortCustomList[], appearanceRows?: SpreadsheetSortAppearanceRows): SpreadsheetSortDialogSource | null;
+export declare function spreadsheetSortRowsMatchRange(rows: readonly (readonly (Cell | null)[])[], range: SpreadsheetCellRange): boolean;
+export declare function spreadsheetSortRowsFromSheet(sheet: WorkSpreadsheetSheet, range: SpreadsheetCellRange): (Cell | null)[][] | null;
+export declare function spreadsheetSortOwnedRangeForExactRange(sheet: WorkSpreadsheetSheet, range: SpreadsheetCellRange): SpreadsheetSortOwnedRange | null;
 export declare function validateSpreadsheetSortRequest(request: SpreadsheetSortRequest): SpreadsheetSortValidationResult;
 export declare function spreadsheetSortFailureMessage(result: SpreadsheetSortValidationResult | SpreadsheetSortResult): string | null;
 export declare function spreadsheetSortAppearanceRowsMatch(rows: readonly (readonly (Cell | null)[])[], appearances: SpreadsheetSortAppearanceRows): boolean;

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

@@ -10,5 +10,8 @@ export declare function workSpreadsheetAutoFilterCriteriaEntries(sheet: WorkSpre
 export declare function workSpreadsheetSheetWithAutoFilterCriteria(sheet: WorkSpreadsheetSheet, column: number, criteria: WorkSpreadsheetFilterCriteria, context?: WorkSpreadsheetDynamicFilterContext): WorkSpreadsheetSheet | null;
 export declare function workSpreadsheetSheetWithoutAutoFilterCriteria(sheet: WorkSpreadsheetSheet, column: number): WorkSpreadsheetSheet | null;
 export declare function workSpreadsheetAutoFilterManuallyHiddenRows(sheet: WorkSpreadsheetSheet): Set<string>;
+export declare function workSpreadsheetAutoFilterOwnedRows(sheet: WorkSpreadsheetSheet): Set<string>;
+export declare function workSpreadsheetFilterHiddenRows(sheet: WorkSpreadsheetSheet, range: WorkSpreadsheetAutoFilterRange, column: number, criteria: WorkSpreadsheetFilterCriteria, context?: WorkSpreadsheetDynamicFilterContext): Record<string, 0> | null;
+export declare function workSpreadsheetSheetWithReappliedAutoFilterCriteria(sheet: WorkSpreadsheetSheet, criteriaSource: WorkSpreadsheetSheet, manuallyHiddenRows: ReadonlySet<string>, context?: WorkSpreadsheetDynamicFilterContext): WorkSpreadsheetSheet;
 export declare function workSpreadsheetSheetWithImportedAutoFilterCriteria(sheet: WorkSpreadsheetSheet, entries: readonly WorkSpreadsheetFilter[], context?: WorkSpreadsheetDynamicFilterContext): WorkSpreadsheetSheet;
 export declare function normalizeWorkSpreadsheetFilterCriteria(criteria: unknown): WorkSpreadsheetFilterCriteria | null;

package/dist/styles.css

@@ -18068,6 +18068,13 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   font-weight: 700;
 }
 
+.work-spreadsheet-sort-options-lock-note {
+  color: var(--a3s-muted);
+  margin: 0 0 2px;
+  font-size: 11px;
+  line-height: 1.45;
+}
+
 .work-spreadsheet-sort-options > label {
   border: 1px solid var(--a3s-line);
   cursor: pointer;
@@ -18122,6 +18129,13 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   gap: 6px;
 }
 
+.work-spreadsheet-sort-toolbar-actions {
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  display: flex;
+}
+
 .work-spreadsheet-sort-toolbar .work-office-checkbox {
   min-height: 34px;
   padding: 6px 9px;
@@ -18314,6 +18328,96 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   line-height: 1.45;
 }
 
+.work-spreadsheet-sort-custom-list-manager {
+  --work-office-control-accent: var(--work-spreadsheet-accent, #159469);
+  width: min(720px, 100%);
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout {
+  grid-template-columns: minmax(220px, .85fr) minmax(280px, 1.15fr);
+  gap: 14px;
+  display: grid;
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout > section, .work-spreadsheet-sort-custom-list-manager-layout label {
+  gap: 7px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout > section {
+  align-content: start;
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout label > span {
+  color: var(--a3s-muted);
+  font-size: 10px;
+  font-weight: 650;
+}
+
+.work-spreadsheet-sort-custom-list-manager select, .work-spreadsheet-sort-custom-list-manager textarea {
+  box-sizing: border-box;
+  border: 1px solid var(--a3s-line-strong);
+  background: var(--a3s-panel);
+  width: 100%;
+  min-width: 0;
+  min-height: 252px;
+  color: var(--a3s-ink);
+  font: inherit;
+  border-radius: 6px;
+  padding: 8px;
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+.work-spreadsheet-sort-custom-list-manager textarea {
+  resize: vertical;
+}
+
+.work-spreadsheet-sort-custom-list-manager textarea[readonly] {
+  background: var(--a3s-panel-soft);
+  color: var(--a3s-muted);
+}
+
+.work-spreadsheet-sort-custom-list-manager select:focus-visible, .work-spreadsheet-sort-custom-list-manager textarea:focus-visible {
+  border-color: var(--work-spreadsheet-accent, #159469);
+  outline: 2px solid
+    color-mix(in srgb, var(--work-spreadsheet-accent, #159469) 24%, transparent);
+  outline-offset: 1px;
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout section > p, .work-spreadsheet-sort-custom-list-manager-note {
+  color: var(--a3s-muted);
+  margin: 0;
+  font-size: 10px;
+  line-height: 1.45;
+}
+
+.work-spreadsheet-sort-custom-list-manager-layout section > .work-spreadsheet-sort-custom-list-error {
+  color: var(--a3s-danger, #b42318);
+}
+
+.work-spreadsheet-sort-custom-list-manager-actions {
+  justify-content: flex-end;
+  align-items: center;
+  gap: 6px;
+  display: flex;
+}
+
+.work-spreadsheet-sort-custom-list-manager-actions .ds-button {
+  gap: 6px;
+}
+
+.work-spreadsheet-sort-custom-list-manager-actions .ds-button[aria-label] {
+  width: 34px;
+  min-width: 34px;
+  padding-inline: 0;
+}
+
+.work-spreadsheet-sort-custom-list-manager-note {
+  margin-block-start: 12px;
+}
+
 .work-spreadsheet-sort-range-dialog {
   --work-office-control-accent: var(--work-spreadsheet-accent, #159469);
   width: min(500px, 100%);
@@ -18395,6 +18499,18 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
     align-items: stretch;
   }
 
+  .work-spreadsheet-sort-toolbar-actions {
+    flex-wrap: wrap;
+  }
+
+  .work-spreadsheet-sort-custom-list-manager-layout {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .work-spreadsheet-sort-custom-list-manager select, .work-spreadsheet-sort-custom-list-manager textarea {
+    min-height: 180px;
+  }
+
   .work-spreadsheet-sort-level {
     grid-template-columns: minmax(0, 1fr);
   }

package/docs/latest/en/browser-editor-architecture.md

@@ -1471,14 +1471,19 @@ first/last placement. The
 normalization, duplicate and size guards, seven immutable month/weekday lists,
 and rank matching; the validated request clones custom entries so command
 execution has no dependency on mutable UI state. The browser adapters own a
-bounded user-list registry and never writes preferences into controlled
-workbook content. Without a store it remains scoped to the mounted session.
+bounded user-list registry and never write preferences into controlled workbook
+content. A dedicated manager stages create, edit, delete, and reorder operations
+against stable list identities, then publishes one normalized preference set.
+Built-ins remain read-only, no-op confirmation skips the storage boundary,
+edited active keys receive the replacement sequence, and deleted active keys
+fall back to ascending value order. Without a store the registry remains scoped
+to the mounted session.
 The optional typed `SpreadsheetSortCustomListStore` synchronously loads and
 saves canonical lists through a host-selected local backend. The provided
 `LocalStorageSpreadsheetSortCustomListStore` accepts an injected Storage
 object, uses a versioned key, and validates, deduplicates, and caps reads at 32
-lists. Corrupt reads fail closed; a rejected write visibly downgrades the new
-list to session scope. A stored list precedes an identical request-carried
+lists. Corrupt reads fail closed; a rejected write visibly downgrades the
+complete changed preference set to session scope. A stored list precedes an identical request-carried
 session copy so persistence identity remains stable. The separate
 `spreadsheet-sort-appearance` model snapshots direct native styles plus
 calculated conditional-format output, preserves no-fill/automatic identities,
@@ -1493,13 +1498,30 @@ view, then uses one stable comparator for both orientations. Relative formula
 references are translated along the moved row or column axis with the same
 bounded reference engine used by Paste Special, while absolute references stay
 fixed.
-One accepted operation crosses the Fortune boundary as one range write and one
-controlled Undo record. Table, worksheet-AutoFilter, hyperlink-map,
-imported-formula-metadata, and border-sidecar intersections fail closed because
-those models still own coordinates outside the cell matrix. Moving large sorts,
-large aggregate/rank scans, remaining advanced filter predicates, full custom-list preference
-management, and structural sidecar reconciliation into the Worker/WASM kernel
-remains Stage 3 work.
+An unfiltered accepted operation crosses the Fortune boundary as one range
+write and one controlled Undo record. A separate structural-owner planner
+recognizes the exact sortable range of one native table or worksheet AutoFilter
+from any contained selection. It excludes table totals, freezes the structural
+header, locks top-to-bottom movement, and carries the owner kind plus table ID
+when applicable. The command derives that fingerprint again at apply time;
+changed ownership fails before allocation or mutation.
+
+Filter-active owned sorts use one controlled workbook replacement instead of a
+range write. The matrix engine returns its stable source-row permutation beside
+the translated cells. `spreadsheet-filter-reconciliation` evaluates typed
+worksheet and table criteria against the sorted dense/sparse sheet, remaps
+opaque Fortune value/color `rowhidden` ownership through that permutation, and
+rebuilds the combined hidden-row map while retaining independent manual rows.
+Fortune range reads that omit hidden rows fall back to the bounded controlled
+snapshot. Sort area and filter rescans have explicit one-million-cell budgets,
+and unrelated filters do not divert ordinary ranges from the native path.
+
+Partial intersections that do not resolve to one exact structural owner, plus
+hyperlink-map, imported-formula-metadata, and border-sidecar intersections,
+still fail closed because those sidecars own coordinates outside the cell
+matrix. Moving large sorts, large aggregate/rank scans, remaining advanced
+filter predicates, and structural sidecar reconciliation into the Worker/WASM
+kernel remains Stage 3 work.
 Direct host focus of the native grid now enters the same bounded focus observer
 used by ribbon commands. If a controlled workbook update replaces the focused
 Fortune overlay, focus transfers to its connected replacement; deliberate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.37.2",
+  "version": "0.37.4",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -111,6 +111,7 @@
     "playground:visual:spreadsheet-row-sort": "playwright test visual-tests/spreadsheet-row-sort.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-text-sort": "playwright test visual-tests/spreadsheet-text-sort.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-sort-range": "playwright test visual-tests/spreadsheet-sort-range.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-owned-range-sort": "playwright test visual-tests/spreadsheet-owned-range-sort.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-font-dialog-shortcuts": "playwright test visual-tests/spreadsheet-font-dialog-shortcuts.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-diagonal-borders": "playwright test visual-tests/spreadsheet-diagonal-borders.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-font-colors-shortcuts": "playwright test visual-tests/spreadsheet-font-colors-shortcuts.functional.spec.ts --config playwright.config.ts",
@@ -202,6 +203,8 @@
     "test:e2e:spreadsheet-text-sort:check": "a3s-test check tests/e2e/spreadsheet-text-sort.acl --json",
     "test:e2e:spreadsheet-sort-range": "A3S_TEST_SUITE=tests/e2e/spreadsheet-sort-range.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:spreadsheet-sort-range:check": "a3s-test check tests/e2e/spreadsheet-sort-range.acl --json",
+    "test:e2e:spreadsheet-owned-range-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-owned-range-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-owned-range-sort:check": "a3s-test check tests/e2e/spreadsheet-owned-range-sort.acl --json",
     "test:e2e:spreadsheet-cell-fill": "a3s-test run tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-cell-fill:check": "a3s-test check tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-auto-sum": "a3s-test run tests/e2e/spreadsheet-auto-sum.acl --json",