@a3s-lab/office 0.36.0 → 0.37.1

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

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

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

@@ -0,0 +1,45 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type SpreadsheetConditionalIconSetName } from '../work-spreadsheet-conditional-icons';
+import type { WorkSpreadsheetSheet } from '../work-types';
+import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
+export type SpreadsheetSortAppearanceKind = 'cell-color' | 'font-color' | 'icon';
+export type SpreadsheetSortAppearancePosition = 'first' | 'last';
+export interface SpreadsheetSortIconTarget {
+    iconSet: SpreadsheetConditionalIconSetName;
+    index: number;
+}
+export type SpreadsheetSortAppearanceTarget = {
+    color: string | null;
+    kind: 'cell-color';
+} | {
+    color: string | null;
+    kind: 'font-color';
+} | {
+    icon: SpreadsheetSortIconTarget;
+    kind: 'icon';
+};
+export interface SpreadsheetSortCellAppearance {
+    /** Undefined means the cell has a native pattern or gradient without one color. */
+    cellColor?: string | null;
+    /** Null represents the automatic/default font color. */
+    fontColor: string | null;
+    icon: SpreadsheetSortIconTarget | null;
+}
+export type SpreadsheetSortAppearanceRows = readonly (readonly SpreadsheetSortCellAppearance[])[];
+export interface SpreadsheetSortAppearanceField {
+    cellColors: readonly (string | null)[];
+    fontColors: readonly (string | null)[];
+    icons: readonly SpreadsheetSortIconTarget[];
+    index: number;
+}
+export declare function createSpreadsheetSortAppearanceRows(sheet: WorkSpreadsheetSheet, range: SpreadsheetCellRange, rows: readonly (readonly (Cell | null)[])[]): SpreadsheetSortAppearanceRows;
+export declare function createSpreadsheetSortDirectAppearanceRows(rows: readonly (readonly (Cell | null)[])[]): SpreadsheetSortAppearanceRows;
+export declare function spreadsheetSortAppearanceFields(rows: SpreadsheetSortAppearanceRows, range: SpreadsheetCellRange, orientation: 'top-to-bottom' | 'left-to-right', hasHeader: boolean): readonly SpreadsheetSortAppearanceField[];
+export declare function normalizeSpreadsheetSortColor(value: unknown): string | null | undefined;
+export declare function normalizeSpreadsheetSortIcon(value: unknown): SpreadsheetSortIconTarget | null;
+export declare function spreadsheetSortAppearanceTargetValue(target: SpreadsheetSortAppearanceTarget): string;
+export declare function parseSpreadsheetSortAppearanceTargetValue(value: string): SpreadsheetSortAppearanceTarget | null;
+export declare function spreadsheetSortAppearanceTargetLabel(target: SpreadsheetSortAppearanceTarget): string;
+export declare function spreadsheetSortAppearanceTargets(field: SpreadsheetSortAppearanceField | undefined, kind: SpreadsheetSortAppearanceKind): readonly SpreadsheetSortAppearanceTarget[];
+export declare function spreadsheetSortAppearanceTargetsEqual(left: SpreadsheetSortAppearanceTarget, right: SpreadsheetSortAppearanceTarget): boolean;
+export declare function spreadsheetSortCellMatchesAppearance(appearance: SpreadsheetSortCellAppearance | undefined, target: SpreadsheetSortAppearanceTarget): boolean;

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

@@ -0,0 +1,8 @@
+export type SpreadsheetSortTextMethod = 'pinyin' | 'stroke';
+export interface SpreadsheetSortTextOptions {
+    caseSensitive: boolean;
+    textMethod: SpreadsheetSortTextMethod;
+}
+export declare const DEFAULT_SPREADSHEET_SORT_TEXT_OPTIONS: SpreadsheetSortTextOptions;
+export declare function isSpreadsheetSortTextMethod(value: unknown): value is SpreadsheetSortTextMethod;
+export declare function createSpreadsheetSortTextComparator(options: SpreadsheetSortTextOptions): ((left: string, right: string) => number) | null;

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

@@ -0,0 +1,3 @@
+import { type OfficeEditorExtension } from './office-editor-extension';
+import type { SpreadsheetCommandContext, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+export declare function createSpreadsheetSortExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

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

@@ -0,0 +1,8 @@
+export declare function SpreadsheetSortCustomListEditor({ error, level, text, onCancel, onChange, onUse, }: {
+    error: string | null;
+    level: number;
+    text: string;
+    onCancel: () => void;
+    onChange: (text: string) => void;
+    onUse: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,13 @@
+export declare const DEFAULT_SPREADSHEET_SORT_CUSTOM_LIST_STORAGE_KEY = "a3s-office.spreadsheet-sort-custom-lists.v1";
+export interface SpreadsheetSortCustomListStore {
+    load(): readonly (readonly string[])[];
+    save(lists: readonly (readonly string[])[]): void;
+}
+export declare class LocalStorageSpreadsheetSortCustomListStore implements SpreadsheetSortCustomListStore {
+    private readonly storage;
+    private readonly key;
+    constructor(storage: Pick<Storage, 'getItem' | 'setItem'>, key?: string);
+    load(): readonly (readonly string[])[];
+    save(lists: readonly (readonly string[])[]): void;
+}
+export declare function normalizeStoredSpreadsheetSortCustomLists(input: unknown): readonly (readonly string[])[];

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

@@ -0,0 +1,26 @@
+export declare const MAX_SPREADSHEET_SORT_CUSTOM_LIST_ENTRIES = 256;
+export declare const MAX_SPREADSHEET_SORT_CUSTOM_LIST_ENTRY_CODE_POINTS = 128;
+export declare const MAX_SPREADSHEET_SORT_CUSTOM_LIST_CODE_POINTS = 4096;
+export declare const MAX_SPREADSHEET_SORT_USER_CUSTOM_LISTS = 32;
+export type SpreadsheetSortCustomListSource = 'built-in' | 'stored' | 'session';
+export interface SpreadsheetSortCustomList {
+    entries: readonly string[];
+    label: string;
+    source: SpreadsheetSortCustomListSource;
+}
+export type SpreadsheetSortCustomListErrorCode = 'duplicate-entry' | 'entry-too-long' | 'invalid-entry' | 'list-too-long' | 'not-enough-entries' | 'too-many-entries';
+export type SpreadsheetSortCustomListValidationResult = {
+    entries: string[];
+    ok: true;
+} | {
+    code: SpreadsheetSortCustomListErrorCode;
+    message: string;
+    ok: false;
+};
+export declare function parseSpreadsheetSortCustomList(text: string): SpreadsheetSortCustomListValidationResult;
+export declare function validateSpreadsheetSortCustomList(input: unknown): SpreadsheetSortCustomListValidationResult;
+export declare function createSpreadsheetSortCustomList(entries: readonly string[], source?: SpreadsheetSortCustomListSource): SpreadsheetSortCustomList | null;
+export declare function mergeSpreadsheetSortCustomLists(lists: readonly SpreadsheetSortCustomList[]): readonly SpreadsheetSortCustomList[];
+export declare function spreadsheetSortCustomListsEqual(left: readonly string[], right: readonly string[]): boolean;
+export declare function spreadsheetSortCustomListMatchKey(value: number | string): string;
+export declare const SPREADSHEET_SORT_BUILT_IN_CUSTOM_LISTS: readonly [SpreadsheetSortCustomList, SpreadsheetSortCustomList, SpreadsheetSortCustomList, SpreadsheetSortCustomList, SpreadsheetSortCustomList, SpreadsheetSortCustomList, SpreadsheetSortCustomList];

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

@@ -0,0 +1,9 @@
+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, }: {
+    source: SpreadsheetSortDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetSortDialogValue) => boolean;
+    onRememberCustomList?: (list: SpreadsheetSortCustomList) => SpreadsheetSortCustomList | void;
+    onClose: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type SpreadsheetSortRequest, type SpreadsheetSortResult } from './spreadsheet-sort';
+import { type SpreadsheetSortAppearanceRows } from './spreadsheet-sort-appearance';
+export declare function sortSpreadsheetMatrix(source: readonly (readonly (Cell | null)[])[], request: SpreadsheetSortRequest, appearanceRows?: SpreadsheetSortAppearanceRows): SpreadsheetSortResult;

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

@@ -0,0 +1,7 @@
+import type { SpreadsheetSortOptions } from './spreadsheet-sort';
+export declare function SpreadsheetSortOptionsDialog({ value, restoreFocusTarget, onApply, onClose, }: {
+    value: SpreadsheetSortOptions;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetSortOptions) => void;
+    onClose: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+import type { SpreadsheetSortKey, SpreadsheetSortOrientation } from './spreadsheet-sort';
+import { type SpreadsheetSortAppearanceField, type SpreadsheetSortAppearanceTarget } from './spreadsheet-sort-appearance';
+import { type SpreadsheetSortCustomList } from './spreadsheet-sort-custom-list';
+export declare function SpreadsheetSortOrderControls({ appearanceField, customLists, level, orientation, sortKey, onBeginCustomListEdit, onChange, }: {
+    appearanceField: SpreadsheetSortAppearanceField | undefined;
+    customLists: readonly SpreadsheetSortCustomList[];
+    level: number;
+    orientation: SpreadsheetSortOrientation;
+    sortKey: SpreadsheetSortKey;
+    onBeginCustomListEdit: (entries?: readonly string[]) => void;
+    onChange: (key: SpreadsheetSortKey) => void;
+}): import("react").JSX.Element;
+export declare function spreadsheetSortAppearanceKey(index: number, target: SpreadsheetSortAppearanceTarget, position: 'first' | 'last'): SpreadsheetSortKey;
+export declare function nextSpreadsheetSortKey(keys: readonly SpreadsheetSortKey[], fields: readonly {
+    index: number;
+}[], appearanceFields: readonly SpreadsheetSortAppearanceField[]): SpreadsheetSortKey | null;

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

@@ -0,0 +1,7 @@
+import type { SpreadsheetSortRangeChoice, SpreadsheetSortRangeDialogSource } from './spreadsheet-sort';
+export declare function SpreadsheetSortRangeDialog({ source, restoreFocusTarget, onApply, onClose, }: {
+    source: SpreadsheetSortRangeDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (choice: SpreadsheetSortRangeChoice) => boolean;
+    onClose: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,138 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+import { type SpreadsheetSortAppearanceKind, type SpreadsheetSortAppearancePosition, type SpreadsheetSortAppearanceRows, type SpreadsheetSortIconTarget } from './spreadsheet-sort-appearance';
+import { type SpreadsheetSortTextOptions } from './spreadsheet-sort-collation';
+import { type SpreadsheetSortCustomList } from './spreadsheet-sort-custom-list';
+export type { SpreadsheetSortAppearanceRows, SpreadsheetSortCellAppearance, SpreadsheetSortIconTarget, } from './spreadsheet-sort-appearance';
+export type { SpreadsheetSortTextMethod, SpreadsheetSortTextOptions, } from './spreadsheet-sort-collation';
+export type { SpreadsheetSortCustomList } from './spreadsheet-sort-custom-list';
+export declare const MAX_SPREADSHEET_SORT_KEYS = 64;
+export declare const MAX_SPREADSHEET_SORT_CELLS = 1000000;
+export type SpreadsheetSortDirection = 'ascending' | 'descending';
+export type SpreadsheetSortOrientation = 'top-to-bottom' | 'left-to-right';
+export type SpreadsheetSortKey = {
+    color?: never;
+    customList?: never;
+    direction: SpreadsheetSortDirection;
+    icon?: never;
+    index: number;
+    position?: never;
+    sortOn?: never;
+} | {
+    color?: never;
+    customList: readonly string[];
+    direction?: never;
+    icon?: never;
+    index: number;
+    position?: never;
+    sortOn?: never;
+} | {
+    color: string | null;
+    customList?: never;
+    direction?: never;
+    icon?: never;
+    index: number;
+    position: SpreadsheetSortAppearancePosition;
+    sortOn: Exclude<SpreadsheetSortAppearanceKind, 'icon'>;
+} | {
+    color?: never;
+    customList?: never;
+    direction?: never;
+    icon: SpreadsheetSortIconTarget;
+    index: number;
+    position: SpreadsheetSortAppearancePosition;
+    sortOn: 'icon';
+};
+export interface SpreadsheetSortOptions extends SpreadsheetSortTextOptions {
+    orientation: SpreadsheetSortOrientation;
+}
+export interface SpreadsheetSortDialogValue extends SpreadsheetSortOptions {
+    hasHeader: boolean;
+    keys: SpreadsheetSortKey[];
+}
+export interface SpreadsheetSortTarget {
+    activeColumn: number;
+    activeRow: number;
+    range: SpreadsheetCellRange;
+}
+export interface SpreadsheetSortRangeCandidate {
+    available: boolean;
+    range: SpreadsheetCellRange;
+}
+export type SpreadsheetSortIntent = {
+    type: 'custom';
+} | {
+    type: 'quick';
+    direction: SpreadsheetSortDirection;
+};
+export interface SpreadsheetSortOpenRequest {
+    activeColumn: number;
+    activeRow: number;
+    expanded?: SpreadsheetSortRangeCandidate;
+    intent: SpreadsheetSortIntent;
+    selected: SpreadsheetSortRangeCandidate;
+    sheetId: string;
+}
+export interface SpreadsheetSortRangePlan {
+    expandedRange: SpreadsheetCellRange | null;
+    selectedRange: SpreadsheetCellRange;
+}
+export type SpreadsheetSortRangeChoice = 'expand' | 'selection';
+export interface SpreadsheetSortRangeDialogSource {
+    canSortExpandedRange: boolean;
+    canSortSelection: boolean;
+    expandedRangeReference: string;
+    selectedRangeReference: string;
+    sheetName: string;
+}
+export type SpreadsheetSortRequest = Omit<SpreadsheetSortDialogValue, keyof SpreadsheetSortTextOptions> & Partial<SpreadsheetSortTextOptions> & {
+    range: SpreadsheetCellRange;
+    sheetId: string;
+};
+export interface SpreadsheetSortNormalizedRequest extends SpreadsheetSortDialogValue {
+    range: SpreadsheetCellRange;
+    sheetId: string;
+}
+export interface SpreadsheetSortField {
+    index: number;
+    label: string;
+}
+export interface SpreadsheetSortDialogSource {
+    activeRow: number;
+    appearanceRows: SpreadsheetSortAppearanceRows;
+    columns: SpreadsheetSortField[];
+    customLists: readonly SpreadsheetSortCustomList[];
+    range: SpreadsheetCellRange;
+    rangeReference: string;
+    rows: SpreadsheetSortField[];
+    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 SpreadsheetSortValidationResult = {
+    ok: true;
+    request: SpreadsheetSortNormalizedRequest;
+} | {
+    code: SpreadsheetSortErrorCode;
+    message: string;
+    ok: false;
+};
+export type SpreadsheetSortResult = {
+    ok: true;
+    rows: (Cell | null)[][];
+} | {
+    code: SpreadsheetSortErrorCode;
+    message: string;
+    ok: false;
+};
+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 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;
+export declare function spreadsheetSortError(code: SpreadsheetSortErrorCode): Extract<SpreadsheetSortValidationResult, {
+    ok: false;
+}>;

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

@@ -0,0 +1,39 @@
+import type { WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableColumn, WorkSpreadsheetTableTotalsFunction } from '../work-types';
+export declare const MAX_SPREADSHEET_TABLE_TOTALS_FORMULA_LENGTH = 8192;
+export declare const MAX_SPREADSHEET_TABLE_TOTALS_LABEL_LENGTH = 255;
+export declare const DEFAULT_SPREADSHEET_TABLE_TOTALS_LABEL = "Total";
+/** The closed function set exposed by the Table Design totals menu. */
+export declare const SPREADSHEET_TABLE_TOTALS_FUNCTIONS: readonly ["sum", "average", "count", "countNums", "max", "min", "stdDev", "stdDevP", "var", "varP", "custom"];
+export interface SpreadsheetTableTotalsColumnPatch {
+    totalsFormula?: string | null;
+    totalsFunction?: WorkSpreadsheetTableTotalsFunction | null;
+    totalsLabel?: string | null;
+}
+export declare function spreadsheetTableTotalsFunctionLabel(value: WorkSpreadsheetTableTotalsFunction | undefined): string;
+export declare function normalizeSpreadsheetTableTotalsFunction(value: unknown): WorkSpreadsheetTableTotalsFunction | undefined;
+/** Normalize a table totals formula to the editable leading-equals form. */
+export declare function normalizeSpreadsheetTableTotalsFormula(value: unknown): string | undefined;
+export declare function normalizeSpreadsheetTableTotalsLabel(value: unknown): string | undefined;
+export declare function spreadsheetTableTotalsFunctionFromOoxml(value: unknown): WorkSpreadsheetTableTotalsFunction | undefined;
+export declare function spreadsheetTableTotalsFunctionToOoxml(value: WorkSpreadsheetTableTotalsFunction | undefined): string | undefined;
+/**
+ * Returns the formula that should be placed in one totals-row cell. Native
+ * aggregate functions use SUBTOTAL so filtered-out rows stay excluded; a
+ * custom rule uses its explicit formula.
+ */
+export declare function spreadsheetTableTotalsFormula(table: WorkSpreadsheetTable, columnOffset: number): string | undefined;
+export declare function spreadsheetTableTotalsColumnPatch(columns: readonly WorkSpreadsheetTableColumn[], patches: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[] | undefined): WorkSpreadsheetTableColumn[] | null;
+/** Apply the native default label used when a totals row is first enabled. */
+export declare function withDefaultSpreadsheetTableTotalsLabel(columns: readonly WorkSpreadsheetTableColumn[], totalsRow: boolean): WorkSpreadsheetTableColumn[];
+/** True when a proposed totals row would overwrite a populated cell. */
+export declare function spreadsheetTableTotalsRowHasContent(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, row?: number): boolean;
+/**
+ * Synchronize totals-row cells after a table metadata change. Explicitly
+ * changed column metadata owns the target cell; untouched manual cells remain
+ * authoritative. The helper works with Fortune's dense and sparse forms.
+ */
+export declare function synchronizeSpreadsheetTableTotalsRow(sheet: WorkSpreadsheetSheet, previousTable: WorkSpreadsheetTable | undefined, nextTable: WorkSpreadsheetTable, options?: {
+    force?: boolean;
+}): WorkSpreadsheetSheet;
+/** Reconcile metadata after a user edits a totals-row cell directly. */
+export declare function reconcileSpreadsheetTableTotalsColumns(sheet: WorkSpreadsheetSheet, table: WorkSpreadsheetTable, editedOffsets?: ReadonlySet<number>): WorkSpreadsheetTableColumn[];

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

@@ -1,6 +1,7 @@
 import type { Selection } from '@fortune-sheet/core';
 import type { WorkSpreadsheetContent, WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableStyle } from '../work-types';
 import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+import { type SpreadsheetTableTotalsColumnPatch } from './spreadsheet-table-totals';
 export { MAX_SPREADSHEET_TABLE_CELLS } from './spreadsheet-table-limits';
 export interface SpreadsheetTableTarget {
     sheetId: string;
@@ -9,6 +10,7 @@ export interface SpreadsheetTableTarget {
 export interface SpreadsheetTableDialogValue {
     headerRow: boolean;
     rangeReference: string;
+    totalsRow?: boolean;
 }
 export interface SpreadsheetTableDialogSource {
     name: string;
@@ -24,6 +26,10 @@ export interface SpreadsheetTableRequest {
     range: SpreadsheetCellRange;
     sheetId: string;
     style?: WorkSpreadsheetTableStyle;
+    /** Create the table with a native totals row appended to the range. */
+    totalsRow?: boolean;
+    /** Initial per-column totals metadata, keyed by zero-based table offset. */
+    totalsColumns?: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[];
 }
 export type SpreadsheetTableValidation = {
     columns: string[];
@@ -36,7 +42,7 @@ export type SpreadsheetTableValidation = {
     message: string;
     ok: false;
 };
-export type SpreadsheetTableErrorCode = 'auto-filter-overlap' | 'invalid-column-name' | 'invalid-name' | 'invalid-range' | 'invalid-style' | 'merged-range' | 'name-conflict' | 'out-of-bounds' | 'protected-range' | 'pivot-table' | 'range-too-large' | 'sheet-not-found' | 'table-overlap';
+export type SpreadsheetTableErrorCode = 'auto-filter-overlap' | 'invalid-column-name' | 'invalid-name' | 'invalid-range' | 'invalid-style' | 'invalid-totals' | 'merged-range' | 'name-conflict' | 'out-of-bounds' | 'protected-range' | 'pivot-table' | 'range-too-large' | 'sheet-not-found' | 'table-overlap' | 'totals-row-content';
 export interface SpreadsheetTableDesignPatch {
     name?: string;
     showColumnStripes?: boolean;
@@ -44,6 +50,10 @@ export interface SpreadsheetTableDesignPatch {
     showLastColumn?: boolean;
     showRowStripes?: boolean;
     style?: WorkSpreadsheetTableStyle;
+    /** Toggle the native totals row. Enabling appends one row to the table. */
+    totalsRow?: boolean;
+    /** Update per-column totals function, label, or custom formula. */
+    totalsColumns?: Readonly<Record<string, SpreadsheetTableTotalsColumnPatch>> | readonly (SpreadsheetTableTotalsColumnPatch | null | undefined)[];
 }
 export declare function createSpreadsheetTableDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetTableTarget): SpreadsheetTableDialogSource | null;
 export declare function spreadsheetTableRangeFromText(value: string): SpreadsheetCellRange | null;

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

@@ -1,9 +1,12 @@
 import type { Selection } from '@fortune-sheet/core';
-import { type RefObject } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 import type { WorkSpreadsheetContent } from '../work-types';
-import type { SpreadsheetAutoFilterCommandPort, SpreadsheetWorkbookCommandPort } from './spreadsheet-command-controller';
+import type { SpreadsheetAutoFilterCommandPort, SpreadsheetEditorCommands, SpreadsheetWorkbookCommandPort } from './spreadsheet-command-controller';
 export interface UseSpreadsheetAutoFilterOptions {
     canvasRef: RefObject<HTMLElement | null>;
+    commandsRef: {
+        current: SpreadsheetEditorCommands | null;
+    };
     content: WorkSpreadsheetContent;
     editable: boolean;
     mountRevision?: number;
@@ -15,7 +18,13 @@ export interface UseSpreadsheetAutoFilterOptions {
 export interface SpreadsheetAutoFilterController {
     active: boolean;
     commandPort: SpreadsheetAutoFilterCommandPort;
+    dialog: ReactNode;
     reserveAltKey: () => boolean;
+    selectionForChange: () => SpreadsheetAutoFilterSelectionState | null;
     status: string;
 }
-export declare function useSpreadsheetAutoFilter({ canvasRef, content, editable, mountRevision, onChange, selection, sheetId, workbook, }: UseSpreadsheetAutoFilterOptions): SpreadsheetAutoFilterController;
+export interface SpreadsheetAutoFilterSelectionState {
+    selections: Selection[];
+    sheetId: string;
+}
+export declare function useSpreadsheetAutoFilter({ canvasRef, commandsRef, content, editable, mountRevision, onChange, selection, sheetId, workbook, }: UseSpreadsheetAutoFilterOptions): SpreadsheetAutoFilterController;

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

@@ -0,0 +1,26 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent } from '../work-types';
+import type { SpreadsheetEditorCommands, SpreadsheetSortCommandPort } from './spreadsheet-command-controller';
+import { type SpreadsheetSortRangeCandidate } from './spreadsheet-sort';
+import { type SpreadsheetSortCustomListStore } from './spreadsheet-sort-custom-list-store';
+interface SpreadsheetSortReadRequest {
+    range: SpreadsheetSortRangeCandidate['range'];
+    sheetId: string;
+}
+export declare function useSpreadsheetSort({ commandsRef, contentRef, focusGrid, getGridFocusTarget, getRows, preview, customListStore, }: {
+    commandsRef: {
+        current: SpreadsheetEditorCommands | null;
+    };
+    contentRef: {
+        current: WorkSpreadsheetContent;
+    };
+    focusGrid: (focusOrigin: Element | null) => void;
+    getGridFocusTarget: () => HTMLElement | null;
+    getRows: (request: SpreadsheetSortReadRequest) => (Cell | null)[][] | null;
+    preview: boolean;
+    customListStore?: SpreadsheetSortCustomListStore;
+}): {
+    commandPort: SpreadsheetSortCommandPort;
+    dialog: import("react").JSX.Element | null;
+};
+export {};

package/dist/internal/features/work/editors/work-office-chrome.d.ts

@@ -8,9 +8,12 @@ export interface WorkOfficeRibbonTab<T extends string> {
 export interface WorkOfficeFileAction {
     id: string;
     label: string;
+    /** Uses a neutral file glyph when omitted so the menu never reserves a blank icon cell. */
     icon?: ReactNode;
     shortcut?: string;
     disabled?: boolean;
+    /** Visually distinguishes an irreversible action without changing its behavior. */
+    danger?: boolean;
     separatorBefore?: boolean;
     onSelect: () => void | Promise<void>;
 }

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

@@ -0,0 +1,14 @@
+import type { WorkSpreadsheetFilter, WorkSpreadsheetFilterCriteria, WorkSpreadsheetSheet } from './work-types';
+import { type WorkSpreadsheetDynamicFilterContext } from './work-spreadsheet-dynamic-filter';
+export interface WorkSpreadsheetAutoFilterRange {
+    column: [number, number];
+    row: [number, number];
+}
+export declare function normalizedWorkSpreadsheetAutoFilterRange(selection: WorkSpreadsheetSheet['filter_select']): WorkSpreadsheetAutoFilterRange | null;
+export declare function workSpreadsheetAutoFilterCriteria(sheet: WorkSpreadsheetSheet | undefined, column: number): WorkSpreadsheetFilterCriteria | null;
+export declare function workSpreadsheetAutoFilterCriteriaEntries(sheet: WorkSpreadsheetSheet): WorkSpreadsheetFilter[];
+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 workSpreadsheetSheetWithImportedAutoFilterCriteria(sheet: WorkSpreadsheetSheet, entries: readonly WorkSpreadsheetFilter[], context?: WorkSpreadsheetDynamicFilterContext): WorkSpreadsheetSheet;
+export declare function normalizeWorkSpreadsheetFilterCriteria(criteria: unknown): WorkSpreadsheetFilterCriteria | null;

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

@@ -0,0 +1,7 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetDynamicFilter } from './work-types';
+export interface WorkSpreadsheetDynamicFilterContext {
+    now: Date;
+}
+export declare function workSpreadsheetDynamicFilterMatcher(kind: WorkSpreadsheetDynamicFilter, cells: Iterable<Cell | null>, context: WorkSpreadsheetDynamicFilterContext): ((cell: Cell | null) => boolean) | null;
+export declare function workSpreadsheetCellIsDate(cell: Cell | null): boolean;

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

@@ -0,0 +1,3 @@
+export declare const WORK_SPREADSHEET_FILTER_TEXT_MAX_CHARACTERS = 32767;
+export declare function workSpreadsheetFilterTextCharacters(value: string): number;
+export declare function workSpreadsheetFilterTextIsBounded(value: string): boolean;

package/dist/internal/features/work/work-spreadsheet-wildcard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Compiles the WPS/OOXML wildcard language into a controlled token matcher. `*`
+ * matches zero or more characters, `?` matches one normalized Unicode
+ * character, and `~` escapes `*`, `?`, or another `~`.
+ */
+export declare function workSpreadsheetWildcardMatcher(source: string): (value: string) => boolean;
+export declare function workSpreadsheetHasUnescapedWildcard(source: string): boolean;

package/dist/internal/features/work/work-types.d.ts

@@ -241,13 +241,23 @@ export interface WorkSpreadsheetTableColumn {
      * stores the editable form with a leading `=`; XLSX table parts omit it.
      */
     calculatedFormula?: string;
+    /**
+     * Native totals-row aggregation. An omitted value means that the totals
+     * cell is not owned by the table. The controlled model uses camelCase names
+     * while XLSX table parts use their OOXML spellings.
+     */
+    totalsFunction?: WorkSpreadsheetTableTotalsFunction;
+    /** Optional text label rendered in this column's totals-row cell. */
+    totalsLabel?: string;
+    /**
+     * A bounded custom totals-row formula. The controlled model stores the
+     * editable form with a leading `=`; XLSX table parts omit it.
+     */
+    totalsFormula?: string;
 }
+export type WorkSpreadsheetTableTotalsFunction = 'sum' | 'average' | 'count' | 'countNums' | 'max' | 'min' | 'stdDev' | 'stdDevP' | 'var' | 'varP' | 'custom';
 export type WorkSpreadsheetDynamicFilter = 'above-average' | 'below-average' | 'tomorrow' | 'today' | 'yesterday' | 'next-week' | 'this-week' | 'last-week' | 'next-month' | 'this-month' | 'last-month' | 'next-quarter' | 'this-quarter' | 'last-quarter' | 'next-year' | 'this-year' | 'last-year' | 'year-to-date' | 'quarter-1' | 'quarter-2' | 'quarter-3' | 'quarter-4' | 'month-1' | 'month-2' | 'month-3' | 'month-4' | 'month-5' | 'month-6' | 'month-7' | 'month-8' | 'month-9' | 'month-10' | 'month-11' | 'month-12';
-export type WorkSpreadsheetTableFilterCriteria = {
-    type: 'values';
-    values: string[];
-    includeBlanks: boolean;
-} | {
+export type WorkSpreadsheetCustomFilterCondition = {
     type: 'equals';
     value: string;
 } | {
@@ -262,9 +272,21 @@ export type WorkSpreadsheetTableFilterCriteria = {
 } | {
     type: 'begins-with';
     value: string;
+} | {
+    type: 'does-not-begin-with';
+    value: string;
 } | {
     type: 'ends-with';
     value: string;
+} | {
+    type: 'does-not-end-with';
+    value: string;
+} | {
+    type: 'matches-wildcard';
+    value: string;
+} | {
+    type: 'does-not-match-wildcard';
+    value: string;
 } | {
     type: 'greater-than';
     value: string;
@@ -277,6 +299,11 @@ export type WorkSpreadsheetTableFilterCriteria = {
 } | {
     type: 'less-than-or-equal';
     value: string;
+};
+export type WorkSpreadsheetFilterCriteria = WorkSpreadsheetCustomFilterCondition | {
+    type: 'values';
+    values: string[];
+    includeBlanks: boolean;
 } | {
     type: 'between';
     lower: string;
@@ -285,6 +312,13 @@ export type WorkSpreadsheetTableFilterCriteria = {
     type: 'not-between';
     lower: string;
     upper: string;
+} | {
+    type: 'compound';
+    conjunction: 'and' | 'or';
+    conditions: [
+        WorkSpreadsheetCustomFilterCondition,
+        WorkSpreadsheetCustomFilterCondition
+    ];
 } | {
     type: 'blanks';
 } | {
@@ -305,10 +339,14 @@ export type WorkSpreadsheetTableFilterCriteria = {
     type: 'dynamic';
     kind: WorkSpreadsheetDynamicFilter;
 };
-export interface WorkSpreadsheetTableFilter {
+/** @deprecated Use `WorkSpreadsheetFilterCriteria` for new integrations. */
+export type WorkSpreadsheetTableFilterCriteria = WorkSpreadsheetFilterCriteria;
+export interface WorkSpreadsheetFilter {
     column: number;
-    criteria: WorkSpreadsheetTableFilterCriteria;
+    criteria: WorkSpreadsheetFilterCriteria;
 }
+/** @deprecated Use `WorkSpreadsheetFilter` for new integrations. */
+export type WorkSpreadsheetTableFilter = WorkSpreadsheetFilter;
 export interface WorkSpreadsheetTable {
     /** Stable browser-model identity. OOXML numeric identity is kept separately. */
     id: string;

package/dist/internal/features/work/work-xlsx-interop.d.ts

@@ -10,13 +10,14 @@ import { type XlsxPageSetup } from './work-xlsx-page-setup';
 import { type XlsxProtectionFeatures } from './work-xlsx-protection';
 import { type XlsxWorksheetXmlScan } from './work-xlsx-worksheet-scan';
 import { type XlsxRichTextCell } from './work-xlsx-rich-text';
-import type { WorkSpreadsheetTable } from './work-types';
+import type { WorkSpreadsheetFilter, WorkSpreadsheetTable } from './work-types';
 type FrozenPane = NonNullable<Sheet['frozen']>;
 export interface XlsxDataValidation {
     references: string[];
     item: FortuneDataValidationItem;
 }
 export interface XlsxSheetFeatures {
+    autoFilterCriteria: WorkSpreadsheetFilter[];
     directCellStyles: XlsxDirectCellStyle[];
     frozen?: FrozenPane;
     validations: XlsxDataValidation[];