@a3s-lab/office 0.37.0 → 0.37.2

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/use-document-review-conflicts.d.ts

@@ -10,6 +10,8 @@ export interface UseDocumentReviewConflictsOptions {
     appliedSourceKeyRef: MutableValue<string>;
     artifactId?: string;
     content: WorkDocumentContent;
+    controlledUpdateRevision?: number;
+    deferControlledUpdates?: boolean;
     editor: Editor | null;
     editorInput: WorkDocumentEditorInput;
     normalizedContent: string;
@@ -17,7 +19,7 @@ export interface UseDocumentReviewConflictsOptions {
     publishedDocumentRef: MutableValue<Editor['state']['doc'] | null>;
     reconcileControlledUpdates?: boolean;
 }
-export declare function useDocumentReviewConflicts({ activeConflictsRef, appliedSourceKeyRef, artifactId, content, editor, editorInput, normalizedContent, onReviewConflict, publishedDocumentRef, reconcileControlledUpdates, }: UseDocumentReviewConflictsOptions): {
+export declare function useDocumentReviewConflicts({ activeConflictsRef, appliedSourceKeyRef, artifactId, content, controlledUpdateRevision, deferControlledUpdates, editor, editorInput, normalizedContent, onReviewConflict, publishedDocumentRef, reconcileControlledUpdates, }: UseDocumentReviewConflictsOptions): {
     dismiss: () => void;
     visibleConflicts: WorkDocumentReviewConflict[];
 };

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

@@ -257,11 +257,7 @@ export interface WorkSpreadsheetTableColumn {
 }
 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;
 } | {
@@ -276,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;
@@ -291,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;
@@ -299,6 +312,13 @@ export type WorkSpreadsheetTableFilterCriteria = {
     type: 'not-between';
     lower: string;
     upper: string;
+} | {
+    type: 'compound';
+    conjunction: 'and' | 'or';
+    conditions: [
+        WorkSpreadsheetCustomFilterCondition,
+        WorkSpreadsheetCustomFilterCondition
+    ];
 } | {
     type: 'blanks';
 } | {
@@ -319,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[];

package/dist/internal/features/work/work-xlsx-table-filters.d.ts

@@ -1,3 +1,5 @@
-import type { WorkSpreadsheetTableFilter } from './work-types';
+import type { WorkSpreadsheetFilter, WorkSpreadsheetTableFilter } from './work-types';
 export declare function readXlsxTableFilters(table: Document, width: number): WorkSpreadsheetTableFilter[];
+export declare function readXlsxAutoFilterColumns(autoFilter: Element, width: number): WorkSpreadsheetFilter[];
 export declare function xlsxTableAutoFilterXml(filters: readonly WorkSpreadsheetTableFilter[], rangeReference: string, totalsRow: boolean): string;
+export declare function xlsxAutoFilterXml(filters: readonly WorkSpreadsheetFilter[], rangeReference: string): string;