@a3s-lab/office 0.37.1 → 0.37.3

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

@@ -0,0 +1,20 @@
+import type { Editor } from '@tiptap/core';
+/**
+ * Keeps controlled TipTap editors from publishing or reconciling content while
+ * the browser and ProseMirror still own an IME composition. The zero-delay
+ * settlement lets ProseMirror flush WebKit's pending DOM records first; the
+ * bounded retries cover runtimes that keep `view.composing` true briefly after
+ * `compositionend` without adding work to ordinary keyboard input.
+ */
+export declare class ControlledEditorComposition {
+    private active;
+    private generation;
+    private settling;
+    private timer;
+    start(): void;
+    end(editor: Editor, onSettled: (editor: Editor) => void): void;
+    isBlocking(editor?: Editor | null): boolean;
+    destroy(): void;
+    private scheduleSettlement;
+    private cancelTimer;
+}

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

@@ -35,5 +35,6 @@ export declare function spreadsheetContentWithSelection(content: WorkSpreadsheet
 export declare function spreadsheetContentWithSelections(content: WorkSpreadsheetContent, sheetId: string, selections: readonly Selection[]): WorkSpreadsheetContent;
 export declare function isSpreadsheetNativeTextUndoTarget(target: EventTarget | null): boolean;
 export declare function isSpreadsheetCellEditingTarget(target: EventTarget | null): boolean;
+export declare function isSpreadsheetCellEditorTarget(target: EventTarget | null): boolean;
 export declare function spreadsheetFormulaBarSelectAllTarget(event: KeyboardEvent): HTMLElement | null;
 export declare function selectSpreadsheetFormulaBarContents(event: KeyboardEvent): boolean;

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

@@ -17,8 +17,9 @@ export interface SpreadsheetEditorProps {
     onAgentRequest?: (request: WorkEditorAgentRequest) => void | Promise<void>;
 }
 export declare function SpreadsheetEditor(props: SpreadsheetEditorProps): import("react").JSX.Element;
-export declare function focusSpreadsheetGrid(container: HTMLElement | null, { focusOrigin, forceInitial, }?: {
+export declare function focusSpreadsheetGrid(container: HTMLElement | null, { focusOrigin, forceCellEditingExit, forceInitial, }?: {
     focusOrigin?: Element | null;
+    forceCellEditingExit?: boolean;
     forceInitial?: boolean;
 }): void;
 export declare function preserveSpreadsheetGridFocus(container: HTMLElement | null, target: EventTarget | null): void;

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

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

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

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

package/dist/internal/features/work/editors/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/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

@@ -644,6 +644,22 @@ The shell never searches visible labels, scrapes rendered text, or synthesizes
 clicks to infer product intent. This keeps localized UI copy independent from
 behavior and gives Worker/WASM operations a stable request contract.
 
+## Controlled rich-text IME boundary
+
+Document body text, visual Markdown, and Presentation text share one internal
+composition coordinator. `compositionstart` blocks host publication and
+controlled-value reconciliation. `compositionend` schedules settlement after
+the current task so ProseMirror can flush WebKit's pending DOM observer records;
+bounded 20 ms retries cover runtimes that briefly retain `view.composing`.
+Only the settled canonical value is published, and an authoritative host value
+received during composition is reconciled afterward.
+
+The coordinator creates no timers or extra renders for ordinary keyboard input.
+Focused component tests cover controlled echo and mid-composition host
+replacement. A dedicated Playwright WebKit gate exercises the browser event
+ordering, asserts zero publications for Pinyin pre-edit text, one publication
+for the committed Chinese value, and the same value after a controlled reopen.
+
 ## Markdown editing flow
 
 ```text
@@ -1455,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,
@@ -1481,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.1",
+  "version": "0.37.3",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -86,6 +86,7 @@
     "playground:bundle-check": "bun scripts/check-playground-bundle.ts",
     "playground:preview": "rspress preview -c website/rspress.config.ts --host 127.0.0.1 --port 4175",
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
+    "playground:ime:webkit": "playwright test --config playwright.ime.config.ts",
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:document-emphasis": "playwright test visual-tests/document-emphasis.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-index": "playwright test visual-tests/document-index.functional.spec.ts --config playwright.config.ts",