@a3s-lab/office 0.37.2 → 0.37.3

package/README.md

@@ -309,9 +309,12 @@ and [CLI reference](./docs/latest/en/cli-reference.md).
 
 ## Current release
 
-Version `0.37.2` keeps the release surface focused on local, testable
+Version `0.37.3` keeps the release surface focused on local, testable
 workflows:
 
+- Spreadsheet Custom Sort now includes a responsive, keyboard-accessible
+  preference manager for creating, editing, deleting, and reordering bounded
+  user sequences while keeping the seven built-in sequences read-only.
 - Document, visual Markdown, and Presentation text composition is safe for
   Chinese and other IMEs: pre-edit text remains local, controlled replacement
   waits for settlement, and only the committed value reaches the host.

package/dist/0~spreadsheet-editor.js

@@ -1,7 +1,7 @@
 import { __webpack_require__ } from "./0~rslib-runtime.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Workbook } from "@fortune-sheet/react";
-import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowDownToLine, ArrowLeft, ArrowLeftToLine, ArrowRight, ArrowRightToLine, ArrowUp, ArrowUpToLine, BadgeJapaneseYen, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, CalendarClock, CalendarDays, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Clock, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Globe2, Grid2X2, Grid3X3, Hash, Info, Italic, KeyRound, Layers2, Link2, Link2Off, ListChecks, ListFilter, ListPlus, LocateFixed, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, Settings2, ShieldCheck, Sigma, SlidersHorizontal, SortAsc, SortDesc, Strikethrough, SwatchBook, Table2, TableProperties, Trash2, TriangleAlert, Underline, Undo2, WrapText, X } from "lucide-react";
+import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowDownToLine, ArrowLeft, ArrowLeftToLine, ArrowRight, ArrowRightToLine, ArrowUp, ArrowUpToLine, BadgeJapaneseYen, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, CalendarClock, CalendarDays, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Clock, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Globe2, Grid2X2, Grid3X3, Hash, Info, Italic, KeyRound, Layers2, Link2, Link2Off, ListChecks, ListFilter, ListOrdered, ListPlus, LocateFixed, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, Settings2, ShieldCheck, Sigma, SlidersHorizontal, SortAsc, SortDesc, Strikethrough, SwatchBook, Table2, TableProperties, Trash2, TriangleAlert, Underline, Undo2, WrapText, X } from "lucide-react";
 import { Fragment as external_react_Fragment, cloneElement, createElement, memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { convertSpanToShareString, genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { freezeImportedSpreadsheetCell, normalizeXlsxSemanticColorOrigin, spreadsheetMatrixProfile, withXlsxPatternFill, withoutEditableRange, normalizeSpreadsheetConditionalVisualOptions, xlsxSemanticColorMatchesValue, withXlsxGradientFill, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, normalizeXlsxPatternFill, withEditableRange, sameSpreadsheetHistoryValue, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, xlsxPatternFillTypes, sheetProtectionAuthority, normalizeXlsxGradientFill, xlsxGradientFillFallbackColor, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSheetProtectionAuthority, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, isSpreadsheetConditionalIconSetName, spreadsheetConditionalThresholdsEqual, spreadsheetConditionalIconSetCount, spreadsheetConditionalIconAppearance } from "./9333.js";
@@ -27408,6 +27408,385 @@ function SpreadsheetSortCustomListEditor({ error, level, text, onCancel, onChang
         ]
     });
 }
+function SpreadsheetSortCustomListManagerDialog({ customLists, restoreFocusTarget, onApply, onClose }) {
+    const builtInLists = useMemo(()=>customLists.filter((list)=>'built-in' === list.source), [
+        customLists
+    ]);
+    const initialUserListsRef = useRef(null);
+    initialUserListsRef.current ??= customLists.filter((list)=>'built-in' !== list.source).map((list, index)=>({
+            id: index,
+            entries: Object.freeze([
+                ...list.entries
+            ]),
+            originalEntries: Object.freeze([
+                ...list.entries
+            ])
+        }));
+    const initialUserLists = initialUserListsRef.current;
+    const nextIdRef = useRef(initialUserLists.length);
+    const listRef = useRef(null);
+    const [userLists, setUserLists] = useState(()=>initialUserLists.map(cloneManagedCustomList));
+    const [selection, setSelection] = useState('built-in:0');
+    const [text, setText] = useState(builtInLists[0]?.entries.join('\n') ?? '');
+    const [error, setError] = useState(null);
+    const userListLabels = useMemo(()=>new Map(userLists.map((list)=>[
+                list.id,
+                managedCustomListLabel(list.entries)
+            ])), [
+        userLists
+    ]);
+    useEffect(()=>listRef.current?.focus(), []);
+    const selectedUserIndex = managedUserListIndex(selection, userLists);
+    const selectedUser = userLists[selectedUserIndex];
+    const selectedBuiltIn = managedBuiltInList(selection, builtInLists);
+    const editingNewList = 'new' === selection;
+    const validateDraft = (rows, excludedId)=>{
+        const validation = parseSpreadsheetSortCustomList(text);
+        if (!validation.ok) {
+            setError(validation.message);
+            return null;
+        }
+        const duplicate = [
+            ...builtInLists.map((list)=>list.entries),
+            ...rows.filter((row)=>row.id !== excludedId).map((row)=>row.entries)
+        ].some((entries)=>spreadsheetSortCustomListsEqual(entries, validation.entries));
+        if (duplicate) {
+            setError('该自定义序列已存在。');
+            return null;
+        }
+        setError(null);
+        return Object.freeze([
+            ...validation.entries
+        ]);
+    };
+    const commitSelectedUser = (rows)=>{
+        const index = managedUserListIndex(selection, rows);
+        const selected = rows[index];
+        if (!selected) return rows;
+        const entries = validateDraft(rows, selected.id);
+        if (!entries) return null;
+        return rows.map((row)=>row.id === selected.id ? {
+                ...row,
+                entries
+            } : row);
+    };
+    const select = (nextSelection)=>{
+        let rows = userLists;
+        if (selectedUser) {
+            const committed = commitSelectedUser(rows);
+            if (!committed) return;
+            rows = committed;
+            setUserLists(rows);
+        } else if (editingNewList && text.trim()) return void setError('请先添加当前序列，或清空项目后再切换。');
+        setSelection(nextSelection);
+        setText(managedSelectionText(nextSelection, builtInLists, rows));
+        setError(null);
+    };
+    const saveSelectedUser = ()=>{
+        const committed = commitSelectedUser(userLists);
+        if (!committed) return;
+        setUserLists(committed);
+        setText(managedSelectionText(selection, builtInLists, committed));
+    };
+    const addNewList = ()=>{
+        if (userLists.length >= 32) return void setError("当前编辑器最多保留 32 个自定义序列。");
+        const entries = validateDraft(userLists, null);
+        if (!entries) return;
+        const id = nextIdRef.current;
+        nextIdRef.current += 1;
+        const next = [
+            ...userLists,
+            {
+                id,
+                entries,
+                originalEntries: null
+            }
+        ];
+        setUserLists(next);
+        setSelection(`user:${id}`);
+        setText(entries.join('\n'));
+    };
+    const moveSelectedUser = (offset)=>{
+        const committed = commitSelectedUser(userLists);
+        if (!committed) return;
+        const index = managedUserListIndex(selection, committed);
+        const nextIndex = index + offset;
+        if (index < 0 || nextIndex < 0 || nextIndex >= committed.length) return;
+        const next = committed.map(cloneManagedCustomList);
+        const selected = next[index];
+        const target = next[nextIndex];
+        if (!selected || !target) return;
+        next[index] = target;
+        next[nextIndex] = selected;
+        setUserLists(next);
+        setText(selected.entries.join('\n'));
+    };
+    const deleteSelectedUser = ()=>{
+        if (!selectedUser) return;
+        const next = userLists.filter((row)=>row.id !== selectedUser.id);
+        setUserLists(next);
+        const fallback = next[selectedUserIndex] ?? next[selectedUserIndex - 1];
+        const nextSelection = fallback ? `user:${fallback.id}` : 'built-in:0';
+        setSelection(nextSelection);
+        setText(managedSelectionText(nextSelection, builtInLists, next));
+        setError(null);
+    };
+    const apply = ()=>{
+        let rows = userLists;
+        if (selectedUser) {
+            const committed = commitSelectedUser(rows);
+            if (!committed) return;
+            rows = committed;
+        } else if (editingNewList && text.trim()) {
+            if (rows.length >= 32) return void setError("当前编辑器最多保留 32 个自定义序列。");
+            const entries = validateDraft(rows, null);
+            if (!entries) return;
+            const id = nextIdRef.current;
+            nextIdRef.current += 1;
+            rows = [
+                ...rows,
+                {
+                    id,
+                    entries,
+                    originalEntries: null
+                }
+            ];
+        }
+        onApply(managedCustomListResult(initialUserLists, rows));
+        onClose();
+    };
+    return /*#__PURE__*/ jsxs(Dialog, {
+        title: "自定义序列",
+        description: "管理排序时可复用的本地序列。内置月份和星期序列保持只读。",
+        className: "work-spreadsheet-sort-custom-list-manager",
+        restoreFocusTarget: restoreFocusTarget,
+        onClose: onClose,
+        footer: /*#__PURE__*/ jsxs(Fragment, {
+            children: [
+                /*#__PURE__*/ jsx(button_Button, {
+                    tone: "quiet",
+                    onClick: onClose,
+                    children: "取消"
+                }),
+                /*#__PURE__*/ jsx(button_Button, {
+                    tone: "primary",
+                    onClick: apply,
+                    children: "确定"
+                })
+            ]
+        }),
+        children: [
+            /*#__PURE__*/ jsxs("div", {
+                className: "work-spreadsheet-sort-custom-list-manager-layout",
+                children: [
+                    /*#__PURE__*/ jsxs("section", {
+                        "aria-label": "可用序列",
+                        children: [
+                            /*#__PURE__*/ jsxs("label", {
+                                children: [
+                                    /*#__PURE__*/ jsx("span", {
+                                        children: "自定义序列"
+                                    }),
+                                    /*#__PURE__*/ jsxs("select", {
+                                        ref: listRef,
+                                        "aria-label": "自定义序列列表",
+                                        size: 10,
+                                        value: selection,
+                                        onChange: (event)=>select(event.currentTarget.value),
+                                        children: [
+                                            /*#__PURE__*/ jsx("optgroup", {
+                                                label: "内置序列",
+                                                children: builtInLists.map((list, index)=>/*#__PURE__*/ jsx("option", {
+                                                        value: `built-in:${index}`,
+                                                        children: list.label
+                                                    }, `built-in:${index}`))
+                                            }),
+                                            userLists.length ? /*#__PURE__*/ jsx("optgroup", {
+                                                label: "用户序列",
+                                                children: userLists.map((list)=>/*#__PURE__*/ jsx("option", {
+                                                        value: `user:${list.id}`,
+                                                        children: userListLabels.get(list.id)
+                                                    }, list.id))
+                                            }) : null
+                                        ]
+                                    })
+                                ]
+                            }),
+                            /*#__PURE__*/ jsxs(button_Button, {
+                                tone: "quiet",
+                                type: "button",
+                                disabled: userLists.length >= 32,
+                                onClick: ()=>select('new'),
+                                children: [
+                                    /*#__PURE__*/ jsx(ListPlus, {
+                                        size: 15,
+                                        "aria-hidden": "true"
+                                    }),
+                                    "新建序列"
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ jsxs("section", {
+                        "aria-label": "序列项目",
+                        children: [
+                            /*#__PURE__*/ jsxs("label", {
+                                children: [
+                                    /*#__PURE__*/ jsx("span", {
+                                        children: "序列项目（每行一个项目）"
+                                    }),
+                                    /*#__PURE__*/ jsx("textarea", {
+                                        "aria-label": "自定义序列项目",
+                                        "aria-invalid": error ? true : void 0,
+                                        readOnly: Boolean(selectedBuiltIn),
+                                        rows: 12,
+                                        value: text,
+                                        onChange: (event)=>{
+                                            setText(event.currentTarget.value);
+                                            setError(null);
+                                        }
+                                    })
+                                ]
+                            }),
+                            /*#__PURE__*/ jsx("p", {
+                                children: selectedBuiltIn ? '内置序列不可修改或删除。' : editingNewList ? '每行、英文逗号或中文逗号可分隔一个项目。' : '修改项目后保存；排序和删除在点击“确定”后统一提交。'
+                            }),
+                            error ? /*#__PURE__*/ jsx("p", {
+                                className: "work-spreadsheet-sort-custom-list-error",
+                                role: "alert",
+                                children: error
+                            }) : null,
+                            /*#__PURE__*/ jsxs("div", {
+                                className: "work-spreadsheet-sort-custom-list-manager-actions",
+                                children: [
+                                    editingNewList ? /*#__PURE__*/ jsxs(button_Button, {
+                                        tone: "primary",
+                                        type: "button",
+                                        onClick: addNewList,
+                                        children: [
+                                            /*#__PURE__*/ jsx(ListPlus, {
+                                                size: 15,
+                                                "aria-hidden": "true"
+                                            }),
+                                            "添加序列"
+                                        ]
+                                    }) : selectedUser ? /*#__PURE__*/ jsxs(button_Button, {
+                                        tone: "primary",
+                                        type: "button",
+                                        onClick: saveSelectedUser,
+                                        children: [
+                                            /*#__PURE__*/ jsx(Save, {
+                                                size: 15,
+                                                "aria-hidden": "true"
+                                            }),
+                                            "保存更改"
+                                        ]
+                                    }) : null,
+                                    /*#__PURE__*/ jsx(button_Button, {
+                                        tone: "quiet",
+                                        type: "button",
+                                        "aria-label": "上移序列",
+                                        title: "上移序列",
+                                        disabled: selectedUserIndex <= 0,
+                                        onClick: ()=>moveSelectedUser(-1),
+                                        children: /*#__PURE__*/ jsx(ArrowUp, {
+                                            size: 15,
+                                            "aria-hidden": "true"
+                                        })
+                                    }),
+                                    /*#__PURE__*/ jsx(button_Button, {
+                                        tone: "quiet",
+                                        type: "button",
+                                        "aria-label": "下移序列",
+                                        title: "下移序列",
+                                        disabled: selectedUserIndex < 0 || selectedUserIndex >= userLists.length - 1,
+                                        onClick: ()=>moveSelectedUser(1),
+                                        children: /*#__PURE__*/ jsx(ArrowDown, {
+                                            size: 15,
+                                            "aria-hidden": "true"
+                                        })
+                                    }),
+                                    /*#__PURE__*/ jsx(button_Button, {
+                                        tone: "quiet",
+                                        type: "button",
+                                        "aria-label": "删除序列",
+                                        title: "删除序列",
+                                        disabled: !selectedUser,
+                                        onClick: deleteSelectedUser,
+                                        children: /*#__PURE__*/ jsx(Trash2, {
+                                            size: 15,
+                                            "aria-hidden": "true"
+                                        })
+                                    })
+                                ]
+                            })
+                        ]
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsxs("p", {
+                className: "work-spreadsheet-sort-custom-list-manager-note",
+                children: [
+                    "最多保存 ",
+                    32,
+                    ' ',
+                    "个用户序列。修改或删除当前使用的序列会同步更新对应排序条件。"
+                ]
+            })
+        ]
+    });
+}
+function managedCustomListResult(initial, current) {
+    const changes = [];
+    for (const original of initial){
+        if (!original.originalEntries) continue;
+        const next = current.find((row)=>row.id === original.id);
+        if (next) {
+            if (!spreadsheetSortCustomListsEqual(original.originalEntries, next.entries)) changes.push({
+                previous: original.originalEntries,
+                next: Object.freeze([
+                    ...next.entries
+                ])
+            });
+        } else changes.push({
+            previous: original.originalEntries,
+            next: null
+        });
+    }
+    return Object.freeze({
+        lists: Object.freeze(current.map((row)=>Object.freeze([
+                ...row.entries
+            ]))),
+        changes: Object.freeze(changes)
+    });
+}
+function managedUserListIndex(selection, lists) {
+    if (!selection.startsWith('user:')) return -1;
+    const id = Number(selection.slice(5));
+    return Number.isSafeInteger(id) ? lists.findIndex((list)=>list.id === id) : -1;
+}
+function managedBuiltInList(selection, lists) {
+    if (!selection.startsWith('built-in:')) return null;
+    const index = Number(selection.slice(9));
+    return Number.isSafeInteger(index) ? lists[index] ?? null : null;
+}
+function managedSelectionText(selection, builtInLists, userLists) {
+    return (managedBuiltInList(selection, builtInLists)?.entries ?? userLists[managedUserListIndex(selection, userLists)]?.entries ?? []).join('\n');
+}
+function cloneManagedCustomList(list) {
+    return {
+        ...list,
+        entries: Object.freeze([
+            ...list.entries
+        ]),
+        originalEntries: list.originalEntries ? Object.freeze([
+            ...list.originalEntries
+        ]) : null
+    };
+}
+function managedCustomListLabel(entries) {
+    return createSpreadsheetSortCustomList(entries, 'session')?.label ?? entries.join(' → ');
+}
 function SpreadsheetSortOptionsDialog({ value, restoreFocusTarget, onApply, onClose }) {
     const [draft, setDraft] = useState(value);
     const formId = useId();
@@ -27866,7 +28245,7 @@ function spreadsheetSortPositionLabel(orientation, position) {
 function isSpreadsheetSortAppearanceKind(value) {
     return 'cell-color' === value || 'font-color' === value || 'icon' === value;
 }
-function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRememberCustomList, onClose }) {
+function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRememberCustomList, onUpdateCustomLists, onClose }) {
     const [value, setValue] = useState(()=>({
             hasHeader: source.value.hasHeader,
             keys: source.value.keys.map(cloneSpreadsheetSortKey),
@@ -27876,6 +28255,7 @@ function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRemember
         }));
     const [verticalHasHeader, setVerticalHasHeader] = useState(source.value.hasHeader);
     const [optionsOpen, setOptionsOpen] = useState(false);
+    const [customListManagerOpen, setCustomListManagerOpen] = useState(false);
     const [customLists, setCustomLists] = useState(()=>initialSpreadsheetSortCustomLists(source));
     const fields = 'top-to-bottom' === value.orientation ? source.columns : source.rows;
     const appearanceFields = useMemo(()=>spreadsheetSortAppearanceFields(source.appearanceRows, source.range, value.orientation, value.hasHeader), [
@@ -27887,6 +28267,7 @@ function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRemember
     const [customListDraft, setCustomListDraft] = useState(null);
     const formId = useId();
     const optionsButtonRef = useRef(null);
+    const customListManagerButtonRef = useRef(null);
     const nextKey = value.keys.length < 64 ? nextSpreadsheetSortKey(value.keys, fields, appearanceFields) : null;
     const replaceKey = (index, replacement)=>{
         setValue((current)=>({
@@ -27985,6 +28366,18 @@ function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRemember
             ]
         });
     };
+    const applyCustomListManagement = (result)=>{
+        const currentUserLists = customLists.filter((list)=>'built-in' !== list.source);
+        const preferencesChanged = currentUserLists.length !== result.lists.length || result.lists.some((entries, index)=>!spreadsheetSortCustomListsEqual(currentUserLists[index]?.entries ?? [], entries));
+        const fallback = result.lists.map((entries)=>createSpreadsheetSortCustomList(entries, 'session')).filter((list)=>null !== list);
+        const updated = preferencesChanged ? onUpdateCustomLists?.(result.lists) ?? fallback : currentUserLists;
+        setCustomLists(mergeSpreadsheetSortCustomLists(updated));
+        setCustomListDraft(null);
+        setValue((current)=>({
+                ...current,
+                keys: current.keys.map((key)=>reconcileManagedCustomListKey(key, result.changes))
+            }));
+    };
     return /*#__PURE__*/ jsxs(Fragment, {
         children: [
             /*#__PURE__*/ jsx(Dialog, {
@@ -28015,40 +28408,60 @@ function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRemember
                         /*#__PURE__*/ jsxs("div", {
                             className: "work-spreadsheet-sort-toolbar",
                             children: [
-                                /*#__PURE__*/ jsxs(button_Button, {
-                                    tone: "quiet",
-                                    type: "button",
-                                    disabled: !nextKey,
-                                    onClick: ()=>{
-                                        if (!nextKey) return;
-                                        setCustomListDraft(null);
-                                        setValue((current)=>({
-                                                ...current,
-                                                keys: [
-                                                    ...current.keys,
-                                                    cloneSpreadsheetSortKey(nextKey)
-                                                ]
-                                            }));
-                                    },
+                                /*#__PURE__*/ jsxs("div", {
+                                    className: "work-spreadsheet-sort-toolbar-actions",
                                     children: [
-                                        /*#__PURE__*/ jsx(ListPlus, {
-                                            size: 15,
-                                            "aria-hidden": "true"
+                                        /*#__PURE__*/ jsxs(button_Button, {
+                                            tone: "quiet",
+                                            type: "button",
+                                            disabled: !nextKey,
+                                            onClick: ()=>{
+                                                if (!nextKey) return;
+                                                setCustomListDraft(null);
+                                                setValue((current)=>({
+                                                        ...current,
+                                                        keys: [
+                                                            ...current.keys,
+                                                            cloneSpreadsheetSortKey(nextKey)
+                                                        ]
+                                                    }));
+                                            },
+                                            children: [
+                                                /*#__PURE__*/ jsx(ListPlus, {
+                                                    size: 15,
+                                                    "aria-hidden": "true"
+                                                }),
+                                                "添加条件"
+                                            ]
                                         }),
-                                        "添加条件"
-                                    ]
-                                }),
-                                /*#__PURE__*/ jsxs(button_Button, {
-                                    ref: optionsButtonRef,
-                                    tone: "quiet",
-                                    type: "button",
-                                    onClick: ()=>setOptionsOpen(true),
-                                    children: [
-                                        /*#__PURE__*/ jsx(Settings2, {
-                                            size: 15,
-                                            "aria-hidden": "true"
+                                        /*#__PURE__*/ jsxs(button_Button, {
+                                            ref: optionsButtonRef,
+                                            tone: "quiet",
+                                            type: "button",
+                                            onClick: ()=>setOptionsOpen(true),
+                                            children: [
+                                                /*#__PURE__*/ jsx(Settings2, {
+                                                    size: 15,
+                                                    "aria-hidden": "true"
+                                                }),
+                                                "选项…"
+                                            ]
                                         }),
-                                        "选项…"
+                                        /*#__PURE__*/ jsxs(button_Button, {
+                                            ref: customListManagerButtonRef,
+                                            tone: "quiet",
+                                            type: "button",
+                                            "aria-label": "管理自定义序列",
+                                            title: "管理自定义序列",
+                                            onClick: ()=>setCustomListManagerOpen(true),
+                                            children: [
+                                                /*#__PURE__*/ jsx(ListOrdered, {
+                                                    size: 15,
+                                                    "aria-hidden": "true"
+                                                }),
+                                                "自定义序列…"
+                                            ]
+                                        })
                                     ]
                                 }),
                                 /*#__PURE__*/ jsx(OfficeCheckbox, {
@@ -28202,10 +28615,30 @@ function SpreadsheetSortDialog({ source, restoreFocusTarget, onApply, onRemember
                 restoreFocusTarget: ()=>optionsButtonRef.current,
                 onApply: applyOptions,
                 onClose: ()=>setOptionsOpen(false)
+            }) : null,
+            customListManagerOpen ? /*#__PURE__*/ jsx(SpreadsheetSortCustomListManagerDialog, {
+                customLists: customLists,
+                restoreFocusTarget: ()=>customListManagerButtonRef.current,
+                onApply: applyCustomListManagement,
+                onClose: ()=>setCustomListManagerOpen(false)
             }) : null
         ]
     });
 }
+function reconcileManagedCustomListKey(key, changes) {
+    if (void 0 === key.customList) return key;
+    const change = changes.find((candidate)=>spreadsheetSortCustomListsEqual(candidate.previous, key.customList ?? []));
+    if (!change) return key;
+    return change.next ? {
+        index: key.index,
+        customList: [
+            ...change.next
+        ]
+    } : {
+        index: key.index,
+        direction: 'ascending'
+    };
+}
 function cloneSpreadsheetSortKey(key) {
     if ('cell-color' === key.sortOn || 'font-color' === key.sortOn) return {
         ...key
@@ -28395,6 +28828,22 @@ function useSpreadsheetSort({ commandsRef, contentRef, focusGrid, getGridFocusTa
     }, [
         customListStore
     ]);
+    const updateCustomLists = useCallback((lists)=>{
+        const normalized = normalizeStoredSpreadsheetSortCustomLists(lists);
+        let source = customListStore ? 'stored' : 'session';
+        if (customListStore) try {
+            customListStore.save(normalized);
+        } catch  {
+            source = 'session';
+            showToast('无法写入本地自定义序列；本次更改仅在当前会话中保留。', 'error');
+        }
+        const next = Object.freeze(normalized.map((entries)=>createSpreadsheetSortCustomList(entries, source)).filter((list)=>null !== list));
+        customListsRef.current = next;
+        setCustomLists(next);
+        return next;
+    }, [
+        customListStore
+    ]);
     const sourceForCandidate = useCallback((request, candidate)=>{
         if (!candidate.available) return null;
         const sheet = contentRef.current.sheets.find((item)=>item.id === request.sheetId);
@@ -28421,28 +28870,13 @@ function useSpreadsheetSort({ commandsRef, contentRef, focusGrid, getGridFocusTa
         const list = createSpreadsheetSortCustomList(candidate.entries, source);
         if (!list) return candidate;
         if (customListsRef.current.length >= 32) return candidate;
-        const next = Object.freeze([
-            ...customListsRef.current,
-            list
+        const next = updateCustomLists([
+            ...customListsRef.current.map((item)=>item.entries),
+            list.entries
         ]);
-        if (customListStore) try {
-            customListStore.save(next.filter((item)=>'stored' === item.source).map((item)=>item.entries));
-        } catch  {
-            showToast('无法写入本地自定义序列；该序列仅在本次会话中保留。', 'error');
-            const session = createSpreadsheetSortCustomList(candidate.entries, 'session') ?? candidate;
-            const fallback = Object.freeze([
-                ...customListsRef.current,
-                session
-            ]);
-            customListsRef.current = fallback;
-            setCustomLists(fallback);
-            return session;
-        }
-        customListsRef.current = next;
-        setCustomLists(next);
-        return list;
+        return next.find((item)=>spreadsheetSortCustomListsEqual(item.entries, list.entries)) ?? list;
     }, [
-        customListStore
+        updateCustomLists
     ]);
     const applyAuthorizedRequest = useCallback((request, selectedRange)=>{
         authorizedRequestRef.current = {
@@ -28594,6 +29028,7 @@ function useSpreadsheetSort({ commandsRef, contentRef, focusGrid, getGridFocusTa
             restoreFocusTarget: restoreFocusTarget,
             onApply: apply,
             onRememberCustomList: rememberCustomList,
+            onUpdateCustomLists: updateCustomLists,
             onClose: close
         }) : surface?.kind === 'range' ? /*#__PURE__*/ jsx(SpreadsheetSortRangeDialog, {
             source: surface.source,

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/styles.css

@@ -18122,6 +18122,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 +18321,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 +18492,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,
@@ -1497,9 +1502,9 @@ 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.
+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.3",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",