@a3s-lab/office 0.36.0 → 0.37.1

package/dist/vue.d.ts

@@ -1,6 +1,6 @@
 import type { Extensions } from '@tiptap/core';
 import { type PropType } from 'vue';
-import type { DocumentContent, DocumentReviewConflictEvent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent } from './core';
+import type { DocumentContent, DocumentReviewConflictEvent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent, SpreadsheetSortCustomListStore } from './core';
 import type { OfficeTheme } from './office-surface';
 import { type DocumentLayoutFont, type OfficeFileAction, type PdfEvidenceOverlay, type PdfEvidenceRegion } from './react';
 export declare const DocumentEditor: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -165,6 +165,7 @@ export declare const SpreadsheetEditor: import("vue").DefineComponent<import("vu
         type: BooleanConstructor;
     };
     saveStatus: StringConstructor;
+    sortCustomListStore: PropType<SpreadsheetSortCustomListStore>;
     theme: {
         readonly default: "system";
         readonly type: PropType<OfficeTheme>;
@@ -192,6 +193,7 @@ export declare const SpreadsheetEditor: import("vue").DefineComponent<import("vu
         type: BooleanConstructor;
     };
     saveStatus: StringConstructor;
+    sortCustomListStore: PropType<SpreadsheetSortCustomListStore>;
     theme: {
         readonly default: "system";
         readonly type: PropType<OfficeTheme>;

package/dist/vue.js

@@ -152,6 +152,7 @@ const SpreadsheetEditor = defineComponent({
             type: Boolean
         },
         saveStatus: String,
+        sortCustomListStore: Object,
         theme: themeProp
     },
     emits: {
@@ -173,6 +174,7 @@ const SpreadsheetEditor = defineComponent({
                 },
                 preview: props.preview,
                 saveStatus: props.saveStatus,
+                sortCustomListStore: props.sortCustomListStore,
                 theme: props.theme
             }));
     }

package/dist/web-component.d.ts

@@ -1,6 +1,6 @@
 import type { Extensions } from '@tiptap/core';
 import { type ReactNode } from 'react';
-import type { DocumentContent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent } from './core';
+import type { DocumentContent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent, SpreadsheetSortCustomListStore } from './core';
 import type { OfficeTheme } from './office-surface';
 import { type DocumentLayoutFont, type OfficeFileAction, type PdfEvidenceOverlay } from './react';
 declare const HTMLElementBase: {
@@ -68,6 +68,8 @@ export declare class A3SSpreadsheetEditorElement extends A3SContentEditorElement
     get collaboration(): OfficeCollaborationSession | undefined;
     set collaboration(value: OfficeCollaborationSession | undefined);
     set kernelWasmUrl(value: string | undefined);
+    get sortCustomListStore(): SpreadsheetSortCustomListStore | undefined;
+    set sortCustomListStore(value: SpreadsheetSortCustomListStore | undefined);
     protected editorNode(): ReactNode;
 }
 export declare class A3SPresentationEditorElement extends A3SContentEditorElement<PresentationContent> {

package/dist/web-component.js

@@ -223,6 +223,7 @@ class A3SMarkdownEditorElement extends A3SContentEditorElement {
 }
 class A3SSpreadsheetEditorElement extends A3SContentEditorElement {
     #collaboration;
+    #sortCustomListStore;
     static get observedAttributes() {
         return [
             'kernel-wasm-url',
@@ -245,6 +246,13 @@ class A3SSpreadsheetEditorElement extends A3SContentEditorElement {
         if (void 0 === value) this.removeAttribute('kernel-wasm-url');
         else this.setAttribute('kernel-wasm-url', value);
     }
+    get sortCustomListStore() {
+        return this.#sortCustomListStore;
+    }
+    set sortCustomListStore(value) {
+        this.#sortCustomListStore = value;
+        this.requestRender();
+    }
     editorNode() {
         if (!this.content) return missingContent('spreadsheet', this.theme);
         return /*#__PURE__*/ createElement(SpreadsheetEditor, {
@@ -257,6 +265,7 @@ class A3SSpreadsheetEditorElement extends A3SContentEditorElement {
             onChange: (content)=>this.changeContent(content),
             preview: this.preview,
             saveStatus: this.saveStatus,
+            sortCustomListStore: this.sortCustomListStore,
             theme: this.theme
         });
     }

package/dist/work-spreadsheet-package-scan.worker.js

@@ -3985,6 +3985,7 @@ https://github.com/nodeca/pako/blob/main/LICENSE
         }
         const IMPORTED_WORKSHEET_ELEMENTS = new Set([
             'pane',
+            'autoFilter',
             'dataValidation',
             'conditionalFormatting',
             'sheetProtection',
@@ -4012,7 +4013,7 @@ https://github.com/nodeca/pako/blob/main/LICENSE
             '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;

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

@@ -1430,8 +1430,142 @@ formulas authored on data rows and totals/header/data selectors. A consistent
 current-row rule is persisted in the table metadata and fills only empty cells
 in newly inserted body rows; manual values and conflicting formulas fail closed.
 Dense and sparse sheet representations use the same path, and native XLSX
-`<calculatedColumnFormula>` metadata round-trips. Complete totals-row
-authoring, slicers, and external/query tables remain open gates.
+`<calculatedColumnFormula>` metadata round-trips. Native totals-row authoring
+now extends the same model: Table Design controls the row and each column's
+label, aggregate, or custom formula; native aggregates map to filter-aware
+`SUBTOTAL` codes; generated cells are reconciled after direct edits, row/column
+changes, and table renames; and `totalsRowFunction`, `totalsRowLabel`, and
+`totalsRowFormula` survive XLSX and Yjs round trips. Occupied, merged,
+protected, overlapping, AutoFilter, unsafe, external, and over-budget targets
+fail closed. Slicers and external/query tables remain open gates.
+
+Value-based multi-key Custom Sort is now owned by a separate
+`spreadsheetSort` editor extension rather than the row/column structure
+extension. The command freezes one continuous selection, derives a header
+candidate, and validates up to 64 unique keys before cloning and stably sorting
+complete cell rows or columns. A nested Traditional Office-compatible Sort Options dialog
+selects top-to-bottom column keys or left-to-right row keys; the latter disables
+header retention because every selected column moves. The same normalized
+options select Simplified Chinese pinyin or stroke collation and optional case
+sensitivity. A key is a closed union
+of ascending/descending value order, an explicit custom sequence, or an
+effective cell-color, font-color, or conditional-icon target with axis-aware
+first/last placement. The
+`spreadsheet-sort-custom-list` model owns
+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.
+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
+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,
+and declines to flatten native patterns or gradients into one color. The
+command reconstructs that snapshot from controlled sheet state and the live
+range immediately before execution, then validates its shape and target
+identities. The `spreadsheet-sort-collation` boundary compiles one local
+`Intl.Collator` per request, keeps numeric text lexical, behavior-probes the
+requested order instead of trusting runtime-specific resolved labels, and fails
+closed when that order is unavailable. A direction-neutral matrix engine transposes only its bounded item
+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.
+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
+pointer, Tab, or active text-editor movement still cancels restoration.
+
+Worksheet AutoFilter conditions now have a separate A3S-owned model and typed
+`spreadsheetAutoFilter` command extension. A versioned condition payload lives
+inside each Fortune filter column only as the grid projection; the controlled
+sheet, absolute header column, exact filter range, and editable state are
+reauthenticated before mutation. The pure evaluator reads dense or sparse cells
+and derives one hidden-row set per column. Their union drives Fortune row
+visibility, while an explicit overlap marker keeps independently hidden rows
+separate when a criterion is replaced or removed. This gives one source of
+truth for multi-column ownership instead of inferring provenance from the
+combined `config.rowhidden` map.
+
+Same-column custom conditions use a separate fixed pair inside the closed
+filter union. Each item is a nonrecursive single-value predicate and the pair
+has one explicit AND/OR discriminator. The evaluator composes exactly two
+matchers, collaboration validation rejects any nested or differently sized
+condition array, and the dialog cannot attach a second condition to range,
+blank, Top/Bottom, or dynamic families.
+
+Wildcard expressions are two additional nonrecursive custom-condition
+variants, so existing equality and other text operands remain literal. A pure
+compiler tokenizes `*`, `?`, and `~` once per criterion, normalizes literal
+segments and cell text with NFKC plus the existing locale-pinned lowercase
+folding, and evaluates the token sequence without executing or interpolating
+user text. The same 32,767-character operand ceiling is enforced by the dialog,
+model, command, and collaboration boundaries. Literal-only spans use ordered
+substring search; long fixed-width candidate scans switch to a bounded bitset
+matcher instead of quadratically rescanning late mismatches.
+
+Top/Bottom criteria take a separate aggregate path before the per-cell matcher.
+The evaluator gathers finite numeric values from the filter column, converts a
+percentage to `ceil(n * percent / 100)` items, sorts in the requested direction,
+and uses the selected boundary as a comparison threshold. Every equal boundary
+value remains visible, while text, Boolean, blank, and nonfinite cells do not
+enter the ranking domain. Dense and sparse cell readers share this path, and
+the resulting hidden-row set remains one independently owned column entry.
+
+Dynamic criteria use a separate pure compiler with an explicit local-clock
+context. Above/below-average consumes the column as an iterable, calculates one
+finite numeric mean, and returns a strict matcher without retaining the column.
+Date families compile one inclusive-start/exclusive-end serial interval and do
+not pre-read the column. They accept imported `Date` objects or finite numeric
+cells explicitly marked `ct.t='d'`, recover SheetJS local-date serials across
+time zones, reject the fictional serial 60, and never classify an unformatted
+number as a date. Relative weeks begin on Sunday; calendar month and quarter
+families classify independently of year. Column profiling is cached per
+immutable sheet and keeps typed dates out of numeric rank actions. The editor
+uses the current local clock, while model tests inject a deterministic clock.
+The controlled model still normalizes dates to the 1900 system; source-level
+1904 retention remains an explicit import boundary.
+
+The same closed `WorkSpreadsheetFilterCriteria` union now serves worksheet and
+table native OOXML. Package scan and import read only the worksheet root's
+direct `<autoFilter>` child, hydrate supported criteria, and retain imported
+unsupported typed criteria without pretending to evaluate them. Export patches
+the generated worksheet element with native `<filterColumn>` children. General
+two-item `<customFilters and="1|0">` groups, arbitrary positive/negative
+wildcard expressions, negative prefix/suffix forms, and
+`<top10 top="..." percent="..." val="..."/>` criteria round-trip through the
+shared worksheet/table path. Imported native dynamic filters are recomputed
+from current cells and emitted as native `<dynamicFilter>` elements. Canonical
+edge-star patterns still normalize to
+the narrower contains, begins-with, or ends-with variants. The
+React adapter owns only vendor-menu discovery, the accessible condition dialog,
+short-lived selection preservation, and focus restoration; unsafe vendor sort
+items are not exposed because they bypass typed sort and structural guards.
+
+Partial-range planning is a separate controlled concern. The shared
+`spreadsheet-current-region` model reads dense `data` and sparse `celldata`
+without materializing worksheet dimensions, so AutoFilter and Sort cannot
+derive different bounds. The command layer creates exact and expanded
+candidates and evaluates mutation and structural guards independently. The
+React adapter owns only the accessible warning/custom-dialog transition and a
+short-lived authorization containing the frozen sort request plus its original
+selection. The command accepts an expanded destination only while the live
+selection still matches that origin; stale host state therefore fails closed.
+The header heuristic likewise reads raw non-formula text instead of formatted
+display strings, keeping numeric and formula result rows in the data body.
 
 Exit criteria: scrolling and selection do not scale with total row count;
 incremental recalculation touches only affected dependency subgraphs; XLSX

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.36.0",
+  "version": "0.37.1",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -104,6 +104,12 @@
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-date-time": "playwright test visual-tests/spreadsheet-date-time.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-copy-from-above": "playwright test visual-tests/spreadsheet-copy-from-above.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-custom-sort": "playwright test visual-tests/spreadsheet-custom-sort.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-custom-list-sort": "playwright test visual-tests/spreadsheet-custom-list-sort.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-appearance-sort": "playwright test visual-tests/spreadsheet-appearance-sort.functional.spec.ts --config playwright.config.ts",
+    "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-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",
@@ -114,6 +120,7 @@
     "playground:visual:spreadsheet-rich-text": "playwright test visual-tests/spreadsheet-rich-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-underline": "playwright test visual-tests/spreadsheet-underline.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-table": "playwright test visual-tests/spreadsheet-table.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-table-totals": "playwright test visual-tests/spreadsheet-table-totals.functional.spec.ts --config playwright.config.ts",
     "playground:visual:presentation-animation": "playwright test visual-tests/presentation-animation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:pdf-page-organization": "playwright test visual-tests/pdf-page-organization.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
@@ -136,6 +143,8 @@
     "test:e2e:pdf-page-organization:check": "a3s-test check tests/e2e/pdf-page-organization.acl --json",
     "test:e2e:presentation-animation": "A3S_TEST_SUITE=tests/e2e/presentation-animation.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:presentation-animation:check": "a3s-test check tests/e2e/presentation-animation.acl --json",
+    "test:e2e:presentation-chinese-ime": "A3S_TEST_SUITE=tests/e2e/presentation-chinese-ime.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:presentation-chinese-ime:check": "a3s-test check tests/e2e/presentation-chinese-ime.acl --json",
     "test:e2e:large-presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && a3s-test run tests/e2e/presentation-large-windowing.acl --json",
     "test:e2e:large-presentation:check": "a3s-test check tests/e2e/presentation-large-windowing.acl --json",
     "test:e2e:initial-focus": "a3s-test run tests/e2e/office-editor-initial-focus.acl --json",
@@ -178,6 +187,20 @@
     "test:e2e:spreadsheet-underline-styles:check": "a3s-test check tests/e2e/spreadsheet-underline-styles.acl --json",
     "test:e2e:spreadsheet-table": "a3s-test run tests/e2e/spreadsheet-table.acl --json",
     "test:e2e:spreadsheet-table:check": "a3s-test check tests/e2e/spreadsheet-table.acl --json",
+    "test:e2e:spreadsheet-table-totals": "a3s-test run tests/e2e/spreadsheet-table-totals.acl --json",
+    "test:e2e:spreadsheet-table-totals:check": "a3s-test check tests/e2e/spreadsheet-table-totals.acl --json",
+    "test:e2e:spreadsheet-custom-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-custom-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-custom-sort:check": "a3s-test check tests/e2e/spreadsheet-custom-sort.acl --json",
+    "test:e2e:spreadsheet-custom-list-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-custom-list-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-custom-list-sort:check": "a3s-test check tests/e2e/spreadsheet-custom-list-sort.acl --json",
+    "test:e2e:spreadsheet-appearance-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-appearance-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-appearance-sort:check": "a3s-test check tests/e2e/spreadsheet-appearance-sort.acl --json",
+    "test:e2e:spreadsheet-row-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-row-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-row-sort:check": "a3s-test check tests/e2e/spreadsheet-row-sort.acl --json",
+    "test:e2e:spreadsheet-text-sort": "A3S_TEST_SUITE=tests/e2e/spreadsheet-text-sort.acl bash scripts/run-a3s-test-web-gate.sh",
+    "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-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",