@a3s-lab/office 0.2.2 → 0.4.0

package/dist/internal/features/work/editors/document-pagination-run-coordinator.d.ts

@@ -0,0 +1,26 @@
+export interface DocumentPaginationRunRequest {
+    invalidateActive?: boolean;
+}
+export interface DocumentPaginationRunCoordinatorOptions {
+    cancelFrame: (frame: number) => void;
+    onAbort?: (reason: 'invalidation' | 'disposal') => void;
+    onCoalescedRequest?: () => void;
+    onError: (error: unknown) => void;
+    onRunFinish?: (aborted: boolean) => void;
+    onRunStart?: () => void;
+    requestFrame: (callback: () => void) => number;
+    run: (signal: AbortSignal) => Promise<void>;
+}
+export interface DocumentPaginationRunCoordinator {
+    dispose: () => void;
+    request: (request?: DocumentPaginationRunRequest) => void;
+}
+/**
+ * Runs document pagination as a single-flight operation.
+ *
+ * Layout observations that arrive during a run are merged into one follow-up
+ * pass. Only document invalidation aborts active work, so observer and font
+ * events cannot continuously starve a large document before it reaches a
+ * stable layout.
+ */
+export declare function createDocumentPaginationRunCoordinator({ cancelFrame, onAbort, onCoalescedRequest, onError, onRunFinish, onRunStart, requestFrame, run, }: DocumentPaginationRunCoordinatorOptions): DocumentPaginationRunCoordinator;

package/dist/internal/features/work/editors/document-picture-properties-dialog-model.d.ts

@@ -1,4 +1,4 @@
-import type { WorkDocumentImageAlignment, WorkDocumentImageLayout, WorkDocumentImageProperties } from '../work-document-image-layout';
+import type { WorkDocumentImageAlignment, WorkDocumentImageHorizontalReference, WorkDocumentImageLayout, WorkDocumentImageProperties, WorkDocumentImageWrapSide, WorkDocumentImageVerticalReference } from '../work-document-image-layout';
 export declare const IMAGE_PIXELS_PER_CENTIMETER: number;
 export interface DocumentPicturePropertiesSource {
     properties: WorkDocumentImageProperties;
@@ -13,12 +13,31 @@ export interface DocumentPicturePropertiesDraft {
     layout: WorkDocumentImageLayout;
     alignment: WorkDocumentImageAlignment;
     wrapDistance: string;
+    wrapSide: WorkDocumentImageWrapSide;
     alternativeText: string;
+    precisePosition: boolean;
+    horizontalOffset: string;
+    verticalOffset: string;
+    horizontalReference: WorkDocumentImageHorizontalReference;
+    verticalReference: WorkDocumentImageVerticalReference;
+    cropTop: string;
+    cropRight: string;
+    cropBottom: string;
+    cropLeft: string;
+    relativeHeight: string;
+    behindDocument: boolean;
+    allowOverlap: boolean;
+    layoutInCell: boolean;
+    lockAnchor: boolean;
 }
 export interface DocumentPicturePropertiesErrors {
     width: string | null;
     height: string | null;
     wrapDistance: string | null;
+    horizontalOffset: string | null;
+    verticalOffset: string | null;
+    crop: string | null;
+    relativeHeight: string | null;
 }
 export declare function createDocumentPicturePropertiesDraft(source: DocumentPicturePropertiesSource): DocumentPicturePropertiesDraft;
 export declare function withDocumentPictureDimension(draft: DocumentPicturePropertiesDraft, dimension: 'height' | 'width', value: string): DocumentPicturePropertiesDraft;

package/dist/internal/features/work/editors/document-review-navigation.d.ts

@@ -0,0 +1,9 @@
+import type { WorkDocumentChange } from '../work-document-changes';
+interface DocumentSelectionRange {
+    from: number;
+    to: number;
+}
+export declare function selectedDocumentChangeIndex(changes: readonly WorkDocumentChange[], selection: DocumentSelectionRange): number | null;
+export declare function adjacentDocumentChangeIndex(changes: readonly WorkDocumentChange[], selection: DocumentSelectionRange, direction: -1 | 1): number | null;
+export declare function actionableDocumentChangeIndex(changes: readonly WorkDocumentChange[], selection: DocumentSelectionRange): number | null;
+export {};

package/dist/internal/features/work/editors/document-statistics-dialog.d.ts

@@ -0,0 +1,7 @@
+import type { DocumentTextStatistics } from './document-editor-support';
+export declare function DocumentStatisticsDialog({ pageCount, restoreFocusTarget, statistics, onClose, }: {
+    pageCount: number;
+    restoreFocusTarget: () => HTMLElement | null;
+    statistics: DocumentTextStatistics;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/internal/features/work/editors/document-status-bar.d.ts

@@ -12,8 +12,9 @@ interface DocumentStatusBarProps {
     wordCount: number;
     zoom: number;
     onSpellcheckChange: (enabled: boolean) => void;
+    onOpenWordCount: () => void;
     onViewModeChange: (mode: DocumentViewMode) => void;
     onZoomChange: (zoom: number) => void;
 }
-export declare function DocumentStatusBar({ bibliographyCount, citationCount, currentPage, pageCount, saveStatus, sectionCount, sectionIndex, spellcheckEnabled, viewMode, wordCount, zoom, onSpellcheckChange, onViewModeChange, onZoomChange, }: DocumentStatusBarProps): import("react").JSX.Element;
+export declare function DocumentStatusBar({ bibliographyCount, citationCount, currentPage, pageCount, saveStatus, sectionCount, sectionIndex, spellcheckEnabled, viewMode, wordCount, zoom, onSpellcheckChange, onOpenWordCount, onViewModeChange, onZoomChange, }: DocumentStatusBarProps): import("react").JSX.Element;
 export {};

package/dist/internal/features/work/editors/document-table-properties-dialog-model.d.ts

@@ -2,6 +2,7 @@ import type { DocumentTableCellFormat } from '../work-document-table-cell-format
 import type { DocumentTableAlignment, DocumentTableCellMarginSide, DocumentTablePreferredWidthType } from '../work-document-table-geometry';
 import type { DocumentTableRowHeightRule, DocumentTableRowOptions } from '../work-document-table-row';
 import type { DocumentTablePropertyChanges, DocumentTableSizingState } from '../work-document-table-sizing';
+import type { DocumentTableColumnWidthType } from '../work-document-table-column-widths';
 export declare const PIXELS_PER_CENTIMETER: number;
 export type DocumentTablePropertiesTab = 'table' | 'row' | 'column' | 'cell';
 export interface DocumentTablePropertiesDraft {
@@ -19,6 +20,7 @@ export interface DocumentTablePropertiesDraft {
         repeatHeader: boolean;
     };
     column: {
+        widthType: DocumentTableColumnWidthType;
         width: string;
     };
     cell: {
@@ -48,4 +50,5 @@ export declare function createDocumentTablePropertiesDraft(source: DocumentTable
 export declare function documentTablePropertiesErrors(draft: DocumentTablePropertiesDraft): DocumentTablePropertiesErrors;
 export declare function hasDocumentTablePropertiesErrors(errors: DocumentTablePropertiesErrors): boolean;
 export declare function draftForTableWidthType(current: DocumentTablePropertiesDraft, widthType: DocumentTablePreferredWidthType, renderedTableWidth: number | undefined): DocumentTablePropertiesDraft;
-export declare function documentTablePropertyChanges(initial: DocumentTablePropertiesDraft, current: DocumentTablePropertiesDraft, source: Pick<DocumentTablePropertiesSource, 'canRepeatHeader' | 'cellFormat' | 'renderedColumnWidths' | 'sizing'>): DocumentTablePropertyChanges | null;
+export declare function draftForColumnWidthType(current: DocumentTablePropertiesDraft, widthType: DocumentTableColumnWidthType, source: Pick<DocumentTablePropertiesSource, 'renderedColumnWidth' | 'renderedTableWidth' | 'sizing'>): DocumentTablePropertiesDraft;
+export declare function documentTablePropertyChanges(initial: DocumentTablePropertiesDraft, current: DocumentTablePropertiesDraft, source: Pick<DocumentTablePropertiesSource, 'canRepeatHeader' | 'cellFormat' | 'renderedColumnWidths' | 'renderedTableWidth' | 'sizing'>): DocumentTablePropertyChanges | null;

package/dist/internal/features/work/editors/document-toolbar.d.ts

@@ -1,54 +1,27 @@
 import type { Editor } from '@tiptap/core';
 import type { WorkDocumentCaptionKind } from '../work-document-captions';
 import type { WorkDocumentFieldKind } from '../work-document-fields';
-import type { WorkDocumentNoteKind } from '../work-document-notes';
 import type { WorkDocumentLayoutFont } from '../work-document-fonts';
-import { type DocumentPageChromeEditingPart } from './document-page-chrome-ribbon';
+import type { WorkDocumentNoteKind } from '../work-document-notes';
+import type { WorkDocumentSectionLayout } from '../work-types';
+import { type DocumentRibbonTabId } from './document-command-catalog';
 import type { DocumentFindReplaceMode } from './document-find-replace-panel';
+import type { DocumentLayoutPanelTab } from './document-layout-panel';
+import { type DocumentPageChromeEditingPart } from './document-page-chrome-ribbon';
+import { type DocumentZoomFit } from './document-zoom';
 import { type WorkOfficeFileAction } from './work-office-chrome';
-declare const documentRibbonTabs: readonly [{
-    readonly id: "home";
-    readonly label: "开始";
-}, {
-    readonly id: "insert";
-    readonly label: "插入";
-}, {
-    readonly id: "page";
-    readonly label: "页面布局";
-    readonly compactLabel: "布局";
-}, {
-    readonly id: "references";
-    readonly label: "引用";
-}, {
-    readonly id: "review";
-    readonly label: "审阅";
-}, {
-    readonly id: "view";
-    readonly label: "视图";
-}];
-declare const documentPictureRibbonTab: {
-    readonly id: "picture";
-    readonly label: "图片";
-};
-declare const documentTableRibbonTabs: readonly [{
-    readonly id: "tableDesign";
-    readonly label: "表格设计";
-    readonly compactLabel: "设计";
-}, {
-    readonly id: "tableLayout";
-    readonly label: "表格布局";
-    readonly compactLabel: "布局";
-}];
-declare const documentPageChromeRibbonTab: {
-    readonly id: "pageChrome";
-    readonly label: "页眉和页脚";
-    readonly compactLabel: "页眉页脚";
-};
-type DocumentRibbonTabId = (typeof documentRibbonTabs)[number]['id'] | typeof documentPictureRibbonTab.id | (typeof documentTableRibbonTabs)[number]['id'] | typeof documentPageChromeRibbonTab.id;
 export type DocumentViewMode = 'page' | 'web';
 interface DocumentToolbarProps {
     editor: Editor;
+    defaultRibbonCollapsed?: boolean;
+    history?: {
+        canRedo: boolean;
+        canUndo: boolean;
+        redo: () => boolean;
+        undo: () => boolean;
+    };
     layoutOpen: boolean;
+    layout: WorkDocumentSectionLayout;
     layoutFonts?: readonly WorkDocumentLayoutFont[];
     navigationOpen: boolean;
     pageColor: string;
@@ -65,6 +38,8 @@ interface DocumentToolbarProps {
     onClosePageChrome: () => void;
     onTogglePageChromePageNumber: () => void;
     onToggleLayout: () => void;
+    onLayoutChange: (layout: WorkDocumentSectionLayout) => void;
+    onOpenLayout: (target: DocumentLayoutPanelTab) => void;
     onToggleNavigation: () => void;
     onTogglePageNumbers: () => void;
     onToggleRulers: () => void;
@@ -72,6 +47,7 @@ interface DocumentToolbarProps {
     onToggleSpellcheck: () => void;
     onViewModeChange: (mode: DocumentViewMode) => void;
     onZoomChange: (zoom: number) => void;
+    onZoomFit: (fit: DocumentZoomFit) => void;
     onInsertSection: () => void;
     onInsertNote: (kind: WorkDocumentNoteKind) => void;
     onInsertCaption: (kind: WorkDocumentCaptionKind) => void;
@@ -94,7 +70,8 @@ interface DocumentToolbarProps {
     onRibbonTabChange?: (tab: DocumentRibbonTabId) => boolean | undefined | Promise<boolean | undefined>;
     onToggleTrackChanges: () => void;
     onToggleChanges: () => void;
+    onOpenWordCount: () => void;
     onOpenFindReplace: (mode: DocumentFindReplaceMode) => void;
 }
-export declare function DocumentToolbar({ editor, layoutOpen, layoutFonts, navigationOpen, pageColor, showPageNumbers, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onToggleNavigation, onTogglePageNumbers, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
+export declare function DocumentToolbar({ editor, defaultRibbonCollapsed, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenWordCount, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
 export {};

package/dist/internal/features/work/editors/document-wps-shortcuts.d.ts

@@ -0,0 +1,12 @@
+import type { Editor } from '@tiptap/core';
+export interface DocumentWpsShortcutCallbacks {
+    canInsertComment: boolean;
+    canRefreshFields: boolean;
+    onInsertComment: () => void;
+    onOpenWordCount: () => void;
+    onRefreshFields: () => void;
+    onToggleSpellcheck: () => void;
+    onToggleTrackChanges: () => void;
+}
+export type DocumentWpsShortcutEvent = Pick<KeyboardEvent, 'altKey' | 'code' | 'ctrlKey' | 'key' | 'metaKey' | 'shiftKey'>;
+export declare function runDocumentWpsShortcut(editor: Editor, event: DocumentWpsShortcutEvent, callbacks: DocumentWpsShortcutCallbacks): boolean;

package/dist/internal/features/work/editors/document-zoom.d.ts

@@ -0,0 +1,17 @@
+export declare const MIN_DOCUMENT_ZOOM = 50;
+export declare const MAX_DOCUMENT_ZOOM = 200;
+export type DocumentZoomFit = 'page' | 'width';
+export interface DocumentZoomFitMetrics {
+    pageHeight: number;
+    pageWidth: number;
+    viewportHeight: number;
+    viewportWidth: number;
+    viewportPadding: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+export declare function clampDocumentZoom(zoom: number): number;
+export declare function documentZoomForFit(fit: DocumentZoomFit, metrics: DocumentZoomFitMetrics): number;

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

@@ -1,2 +1,2 @@
 export type MarkdownEditingSurface = 'source' | 'visual';
-export declare function restoreMarkdownEditingSurfaceFocus(getTarget: () => HTMLElement | null): void;
+export declare function restoreMarkdownEditingSurfaceFocus(getTarget: () => HTMLElement | null, focusOrigin?: Element | null): void;

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

@@ -1,10 +1,14 @@
 import type { Extensions } from '@tiptap/core';
+import type { WorkOfficeCollaborationSession } from '../../../collaboration/office-collaboration';
 import { markdownTaskCheckboxLabel } from '../work-markdown-extensions';
 import { type WorkGetMarkdownSelectionMenuItems } from '../work-markdown-selection-menu';
 import type { WorkMarkdownContent } from '../work-types';
 import { type WorkOfficeFileAction } from './work-office-chrome';
 export { markdownTaskCheckboxLabel };
 export interface MarkdownEditorProps {
+    /** The host must initialize and synchronize this session before mounting. */
+    collaboration?: WorkOfficeCollaborationSession;
+    autoFocus?: boolean;
     content: WorkMarkdownContent;
     extensions?: Extensions;
     preview: boolean;
@@ -13,4 +17,4 @@ export interface MarkdownEditorProps {
     getSelectionMenuItems?: WorkGetMarkdownSelectionMenuItems;
     onChange: (content: WorkMarkdownContent) => void;
 }
-export declare function MarkdownEditor({ content, extensions: additionalExtensions, preview, saveStatus, fileActions, getSelectionMenuItems, onChange, }: MarkdownEditorProps): import("react").JSX.Element;
+export declare function MarkdownEditor({ autoFocus, collaboration, content, extensions: additionalExtensions, preview, saveStatus, fileActions, getSelectionMenuItems, onChange, }: MarkdownEditorProps): import("react").JSX.Element;

package/dist/internal/features/work/editors/markdown-toolbar.d.ts

@@ -2,9 +2,10 @@ import type { Editor } from '@tiptap/core';
 import type { MarkdownSourceCommand, MarkdownSourceSelectionState } from './markdown-source-commands';
 import type { MarkdownViewMode } from './markdown-workspace';
 import { type WorkOfficeFileAction } from './work-office-chrome';
-export declare function MarkdownToolbar({ editor, fileActions, sourceEditing, canSourceRedo, canSourceUndo, viewMode, getSourceFocusTarget, getSourceSelection, onSourceCommand, onSourceRedo, onSourceReplace, onSourceUndo, onViewModeChange, }: {
+export declare function MarkdownToolbar({ editor, fileActions, collaborative, sourceEditing, canSourceRedo, canSourceUndo, viewMode, getSourceFocusTarget, getSourceSelection, onSourceCommand, onSourceRedo, onSourceReplace, onSourceUndo, onViewModeChange, }: {
     editor: Editor;
     fileActions?: readonly WorkOfficeFileAction[];
+    collaborative: boolean;
     sourceEditing: boolean;
     canSourceRedo: boolean;
     canSourceUndo: boolean;

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

@@ -0,0 +1,3 @@
+export declare function WorkOfficeCollaborationParticipants({ variant, }: {
+    variant?: 'status' | 'toolbar';
+}): import("react").JSX.Element | null;

package/dist/internal/features/work/editors/office-collaboration-presence-context.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from 'react';
+import { type WorkOfficeCollaborationSession } from '../../../collaboration/office-collaboration';
+import type { WorkOfficeCollaborationParticipant, WorkOfficeCollaborationPresence } from '../../../collaboration/office-collaboration-presence';
+type OfficeCollaborationLocationNavigator = (participant: WorkOfficeCollaborationParticipant) => boolean;
+export declare function OfficeCollaborationPresenceProvider({ children, presence, }: {
+    children: ReactNode;
+    presence?: WorkOfficeCollaborationPresence;
+}): import("react").JSX.Element;
+export declare function useOfficeCollaborationPresence(): WorkOfficeCollaborationPresence | undefined;
+export declare function useOfficeCollaborationLocationNavigator(navigator: OfficeCollaborationLocationNavigator): void;
+export declare function useOfficeCollaborationParticipantNavigation(): OfficeCollaborationLocationNavigator | undefined;
+export declare function assertOfficeCollaborationPresencePairing({ expectedKind, presence, session, }: {
+    expectedKind: WorkOfficeCollaborationSession['kind'];
+    presence?: WorkOfficeCollaborationPresence;
+    session?: WorkOfficeCollaborationSession;
+}): void;
+export {};

package/dist/internal/features/work/editors/office-collaboration-presence-ui.d.ts

@@ -0,0 +1,25 @@
+import type { Editor } from '@tiptap/core';
+import { type CSSProperties, type RefObject } from 'react';
+import type { WorkOfficeCollaborationParticipant, WorkOfficeCollaborationPresenceLocation, WorkOfficeCollaborationPresenceSnapshot } from '../../../collaboration/office-collaboration-presence';
+export type OfficePresenceColorStyle = CSSProperties & {
+    '--work-office-presence-color': string;
+};
+export declare function useOfficePresenceSnapshot(): WorkOfficeCollaborationPresenceSnapshot | undefined;
+export declare function useOfficeRemoteParticipants(): readonly WorkOfficeCollaborationParticipant[];
+export declare function useOfficePublishPresenceLocation(location: WorkOfficeCollaborationPresenceLocation | null): void;
+export declare function OfficePresenceAvatar({ compact, participant, }: {
+    compact?: boolean;
+    participant: WorkOfficeCollaborationParticipant;
+}): import("react").JSX.Element;
+export declare function officePresenceColorStyle(participant: WorkOfficeCollaborationParticipant): OfficePresenceColorStyle;
+export declare function officePresenceColor(participant: WorkOfficeCollaborationParticipant): string;
+export declare function OfficeTiptapPresenceLayer({ containerRef, editor, kind, markdownSurface, }: {
+    containerRef: RefObject<HTMLElement | null>;
+    editor: Editor | null;
+    kind: 'document' | 'markdown';
+    markdownSurface?: 'visual';
+}): import("react").JSX.Element | null;
+export declare function MarkdownSourcePresenceLayer({ markdown, sourceRef, }: {
+    markdown: string;
+    sourceRef: RefObject<HTMLTextAreaElement | null>;
+}): import("react").JSX.Element | null;

package/dist/internal/features/work/editors/office-editor-focus-handoff.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from 'react';
+type OfficeEditorFocusOrigin = Element | null;
+/**
+ * Captures the focused opener before a lazy editor suspends so the mounted
+ * editing surface can claim that focus without overriding later navigation.
+ */
+export declare function OfficeEditorFocusHandoff({ children, }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Returns the pre-suspense opener, or captures the local mount origin. */
+export declare function useOfficeEditorFocusOrigin(): OfficeEditorFocusOrigin;
+interface OfficeEditorInitialFocusOptions {
+    enabled: boolean;
+    getTarget: () => HTMLElement | null;
+    isTargetReady?: (target: HTMLElement) => boolean;
+}
+/**
+ * Claims first-open focus only after the editing target is ready, then keeps
+ * it stable across the brief DOM replacement window used by rich editors.
+ */
+export declare function useOfficeEditorInitialFocus({ enabled, getTarget, isTargetReady, }: OfficeEditorInitialFocusOptions): void;
+/**
+ * Returns a cleanup that cancels the bounded first-open focus handoff.
+ * Deliberate pointer navigation, Tab navigation, or unrelated focus wins.
+ */
+export declare function stabilizeOfficeEditorInitialFocus(getTarget: () => HTMLElement | null, focusOrigin?: Element | null, isTargetReady?: (target: HTMLElement) => boolean): () => void;
+export {};

package/dist/internal/features/work/editors/pdf-annotation-controller.d.ts

@@ -15,6 +15,11 @@ export interface PdfAnnotationControllerState {
 export interface PdfAnnotationController {
     state: PdfAnnotationControllerState;
     deleteSelection: () => void;
+    getSelectionLocation: () => {
+        annotationId: string;
+        pageIndex: number;
+    } | null;
+    locateAnnotation: (pageIndex: number, annotationId: string) => boolean;
     setAnnotationColor: (color: string) => void;
     setAnnotationOpacity: (opacity: number) => void;
     setAnnotationStrokeWidth: (strokeWidth: number) => void;

package/dist/internal/features/work/editors/pdf-collaboration-presence.d.ts

@@ -0,0 +1,3 @@
+export declare function PdfCollaborationPresenceLayer({ pageIndex, }: {
+    pageIndex: number;
+}): import("react").JSX.Element | null;

package/dist/internal/features/work/editors/pdf-collaboration-projection.d.ts

@@ -0,0 +1,10 @@
+import { type PluginRegistry } from '@embedpdf/react-pdf-viewer';
+import type { WorkOfficeCollaborationSession } from '../../../collaboration/office-collaboration';
+import { type WorkOfficePdfCollaborationBinding } from '../../../collaboration/office-pdf-collaboration';
+export interface WorkPdfCollaborationProjection {
+    readonly binding: WorkOfficePdfCollaborationBinding;
+    readonly ready: Promise<void>;
+    subscribeError(listener: (error: unknown) => void): () => void;
+    destroy(): void;
+}
+export declare function createWorkPdfCollaborationProjection(registry: PluginRegistry, session: WorkOfficeCollaborationSession): WorkPdfCollaborationProjection;

package/dist/internal/features/work/editors/pdf-evidence-contract.d.ts

@@ -0,0 +1,36 @@
+export declare const PDF_EVIDENCE_COORDINATE_BASIS: 1000000;
+export interface PdfEvidenceBounds {
+    bottom: number;
+    left: number;
+    right: number;
+    top: number;
+}
+export interface PdfEvidenceRegion {
+    bounds: PdfEvidenceBounds;
+    id: string;
+    label?: string;
+    sourceRegionIds: readonly string[];
+    targetIds: readonly string[];
+}
+export interface PdfEvidencePage {
+    canvasHeight: number;
+    canvasId: string;
+    canvasKind: 'source';
+    canvasWidth: number;
+    coordinateBasis: typeof PDF_EVIDENCE_COORDINATE_BASIS;
+    pageNumber: number;
+    regions: readonly PdfEvidenceRegion[];
+    renderProfileSha256: string;
+    rotationDegrees: 0 | 90 | 180 | 270;
+    sourceSha256: string;
+}
+export interface PdfEvidenceRegionLocation {
+    pageNumber: number;
+}
+export interface PdfEvidenceOverlay {
+    coordinateBasis: typeof PDF_EVIDENCE_COORDINATE_BASIS;
+    loadPage: (pageNumber: number, signal: AbortSignal) => Promise<PdfEvidencePage | null>;
+    locateRegion?: (regionId: string, signal: AbortSignal) => Promise<PdfEvidenceRegionLocation | null>;
+    renderProfileSha256: string;
+    sourceSha256: string;
+}

package/dist/internal/features/work/editors/pdf-evidence-overlay.d.ts

@@ -0,0 +1,37 @@
+import { type DocumentManagerCapability, type PluginRegistry, type ScrollCapability, type ViewportCapability, type ZoomCapability } from '@embedpdf/react-pdf-viewer';
+import { type PdfEvidenceBounds, type PdfEvidenceOverlay, type PdfEvidencePage, type PdfEvidenceRegion } from './pdf-evidence-contract';
+export { PDF_EVIDENCE_COORDINATE_BASIS, type PdfEvidenceBounds, type PdfEvidenceOverlay, type PdfEvidencePage, type PdfEvidenceRegion, type PdfEvidenceRegionLocation, } from './pdf-evidence-contract';
+interface PdfEvidenceOverlayLayerProps {
+    currentPage: number;
+    evidenceOverlay: PdfEvidenceOverlay;
+    onEvidenceRegionSelect?: (region: PdfEvidenceRegion) => void;
+    registry: PluginRegistry;
+    selectedEvidenceRegionId?: string;
+    sourceKey?: string;
+}
+interface EvidenceRuntime {
+    documentManager: DocumentManagerCapability;
+    scroll: ScrollCapability;
+    viewport: ViewportCapability;
+    zoom: ZoomCapability | null;
+}
+export declare function PdfEvidenceOverlayLayer({ currentPage, evidenceOverlay, onEvidenceRegionSelect, registry, selectedEvidenceRegionId, sourceKey, }: PdfEvidenceOverlayLayerProps): import("react").JSX.Element | null;
+export declare function validatePdfEvidencePage(page: PdfEvidencePage, overlay: PdfEvidenceOverlay, runtime: EvidenceRuntime, requestedPage: number): void;
+export declare function pdfEvidenceBoundsToPageRect(bounds: PdfEvidenceBounds, width: number, height: number): {
+    origin: {
+        x: number;
+        y: number;
+    };
+    size: {
+        height: number;
+        width: number;
+    };
+};
+export declare function pdfEvidencePointToUnrotatedPage(point: {
+    x: number;
+    y: number;
+}, pageWidth: number, pageHeight: number, rotation: 0 | 1 | 2 | 3): {
+    x: number;
+    y: number;
+};
+export declare function pdfEvidenceHorizontalCenterOffset(viewportClientWidth: number, viewportGap: number, contentWidth: number, zoom: number): number;

package/dist/internal/features/work/editors/pdf-toolbar.d.ts

@@ -9,12 +9,13 @@ interface PdfPageNavigationControl {
     onOpen: () => void;
     toggleRef: RefObject<HTMLButtonElement | null>;
 }
-export declare function PdfToolbar({ annotationState, can, commands, editable, pageNavigation, saveLabel, saveState, searchInputRef, state, }: {
+export declare function PdfToolbar({ annotationState, can, commands, editable, pageNavigation, saveAvailable, saveLabel, saveState, searchInputRef, state, }: {
     annotationState: PdfAnnotationControllerState;
     can: PdfEditorCanCommands;
     commands: PdfEditorCommands;
     editable: boolean;
     pageNavigation?: PdfPageNavigationControl;
+    saveAvailable?: boolean;
     saveLabel: string;
     saveState: PdfSaveState;
     searchInputRef: RefObject<HTMLInputElement | null>;

package/dist/internal/features/work/editors/pdf-viewer-controller.d.ts

@@ -44,5 +44,11 @@ export interface PdfViewerController {
     zoomIn: () => void;
     zoomOut: () => void;
 }
+export interface PdfViewerHistoryOverride {
+    canRedo: boolean;
+    canUndo: boolean;
+    redo: () => void;
+    undo: () => void;
+}
 export declare const initialPdfViewerControllerState: PdfViewerControllerState;
-export declare function usePdfViewerController(registry: PluginRegistry | null): PdfViewerController;
+export declare function usePdfViewerController(registry: PluginRegistry | null, historyOverride?: PdfViewerHistoryOverride): PdfViewerController;

package/dist/internal/features/work/editors/pdf-viewer.d.ts

@@ -1,11 +1,21 @@
 import { type UISchema } from '@embedpdf/react-pdf-viewer';
+import type { WorkOfficeCollaborationSession } from '../../../collaboration/office-collaboration';
+import type { WorkPdfCollaborationContent } from '../../../collaboration/office-pdf-collaboration-types';
+import type { PdfEvidenceOverlay, PdfEvidenceRegion } from './pdf-evidence-contract';
 export declare const a3sPdfUiSchema: UISchema;
 export interface PdfViewerProps {
+    collaboration?: WorkOfficeCollaborationSession;
+    evidenceOverlay?: PdfEvidenceOverlay;
     fileName?: string;
     loadSource: () => Promise<Blob>;
+    onCollaborationChange?: (content: WorkPdfCollaborationContent) => void;
+    onEvidenceRegionSelect?: (region: PdfEvidenceRegion) => void;
+    onPageChange?: (pageNumber: number) => void;
     onSave?: (pdf: Blob) => Promise<boolean>;
     saveLabel?: string;
+    selectedEvidenceRegionId?: string;
     sourceKey?: string;
     wasmUrl?: string;
+    worker?: boolean;
 }
-export declare function PdfViewer({ fileName, loadSource, onSave, saveLabel, sourceKey, wasmUrl, }: PdfViewerProps): import("react").JSX.Element;
+export declare function PdfViewer({ collaboration, evidenceOverlay, fileName, loadSource, onCollaborationChange, onEvidenceRegionSelect, onPageChange, onSave, saveLabel, selectedEvidenceRegionId, sourceKey, wasmUrl, worker, }: PdfViewerProps): import("react").JSX.Element;

package/dist/internal/features/work/editors/presentation-collaboration-presence.d.ts

@@ -0,0 +1,5 @@
+import type { WorkSlideElement } from '../work-types';
+export declare function PresentationCollaborationPresenceLayer({ elements, slideId, }: {
+    elements: readonly WorkSlideElement[];
+    slideId: string;
+}): import("react").JSX.Element | null;

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

@@ -7,6 +7,7 @@ export interface PresentationWorkspaceFocusState extends PresentationObjectFocus
     selectedSlideId: string;
     viewMode: 'normal' | 'sorter';
 }
-export declare function restorePresentationObjectFocus(container: HTMLElement | null, getState: () => PresentationObjectFocusState): void;
-export declare function restorePresentationWorkspaceFocus(root: HTMLElement | null, getState: () => PresentationWorkspaceFocusState): void;
+export declare function restorePresentationObjectFocus(container: HTMLElement | null, getState: () => PresentationObjectFocusState, focusOrigin?: Element | null): void;
+export declare function restorePresentationWorkspaceFocus(root: HTMLElement | null, getState: () => PresentationWorkspaceFocusState, focusOrigin?: Element | null): void;
+export declare function presentationWorkspaceFocusTarget(root: HTMLElement, state: PresentationWorkspaceFocusState): HTMLElement | undefined;
 export declare function presentationCommandsWithObjectFocus(commands: PresentationEditorCommands, restoreFocus: () => void): PresentationEditorCommands;

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

@@ -1,8 +1,11 @@
+import type { WorkOfficeCollaborationSession } from '../../../collaboration/office-collaboration';
 import type { WorkEditorAgentRequest } from '../work-agent-request';
 import type { WorkPresentationContent } from '../work-types';
 import type { WorkOfficeFileAction } from './work-office-chrome';
 export type PresentationDesignMode = 'slide' | 'layout' | 'master';
 export interface PresentationEditorProps {
+    autoFocus?: boolean;
+    collaboration?: WorkOfficeCollaborationSession;
     content: WorkPresentationContent;
     preview: boolean;
     saveStatus?: string;

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

@@ -1,3 +1,3 @@
 import type { PresentationEditorProps } from './presentation-editor-types';
 export type { PresentationEditorProps } from './presentation-editor-types';
-export declare function PresentationEditor(props: PresentationEditorProps): import("react").JSX.Element | null;
+export declare function PresentationEditor(props: PresentationEditorProps): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { Selection } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
+export interface SpreadsheetAutoFilterRange {
+    row: [number, number];
+    column: [number, number];
+}
+export declare function spreadsheetAutoFilterRange(sheet: WorkSpreadsheetSheet, selection: Selection): SpreadsheetAutoFilterRange | null;
+export declare function spreadsheetAutoFilterHeaderColumn(sheet: WorkSpreadsheetSheet | undefined, selection: Selection): number | null;
+export declare function toggleSpreadsheetAutoFilter(content: WorkSpreadsheetContent, sheetId: string, selection: Selection): WorkSpreadsheetContent | null;

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

@@ -0,0 +1,3 @@
+import type { Selection, Sheet } from '@fortune-sheet/core';
+export type SpreadsheetCellClearMode = 'all' | 'formats' | 'contents' | 'comments' | 'hyperlinks';
+export declare function clearSpreadsheetSheetSelection(sheet: Sheet, selection: Pick<Selection, 'row' | 'column'>, mode: SpreadsheetCellClearMode): Sheet;

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

@@ -0,0 +1,12 @@
+import type { WorkSpreadsheetSheet } from '../work-types';
+export type SpreadsheetCellMergeCommand = 'merge-and-center' | 'merge-cells' | 'merge-across' | 'unmerge-cells' | 'unmerge-and-fill';
+export interface SpreadsheetCellMergeRange {
+    row: number[];
+    column: number[];
+}
+export interface SpreadsheetCellMergeApiCall {
+    name: string;
+    args: unknown[];
+}
+export declare function canApplySpreadsheetCellMerge(sheet: WorkSpreadsheetSheet | undefined, range: SpreadsheetCellMergeRange, command: SpreadsheetCellMergeCommand): boolean;
+export declare function spreadsheetCellMergeApiCalls(sheet: WorkSpreadsheetSheet | undefined, sheetId: string, range: SpreadsheetCellMergeRange, command: SpreadsheetCellMergeCommand): SpreadsheetCellMergeApiCall[];

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

@@ -1,9 +1,5 @@
-import { type SpreadsheetClipboardPort } from './spreadsheet-context-menu';
 export interface SpreadsheetClipboardShortcutOptions {
-    clipboard: SpreadsheetClipboardPort;
-    clearSelectedCells(): boolean;
-    pasteCells(values: readonly (readonly unknown[])[]): boolean;
-    readSelectionText(): string | null;
-    restoreFocus(): void;
+    canExecute(): boolean;
+    execute(): boolean;
 }
-export declare function runSpreadsheetClipboardShortcut(event: KeyboardEvent, options: SpreadsheetClipboardShortcutOptions): boolean;
+export declare function runSpreadsheetClipboardShortcut(event: KeyboardEvent, canExecute: SpreadsheetClipboardShortcutOptions['canExecute'], execute: SpreadsheetClipboardShortcutOptions['execute']): boolean;

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

@@ -0,0 +1,9 @@
+import type { Presence } from '@fortune-sheet/core';
+import type { WorkbookInstance } from '@fortune-sheet/react';
+import type { WorkOfficeCollaborationParticipant } from '../../../collaboration/office-collaboration-presence';
+import type { WorkSpreadsheetContent } from '../work-types';
+export declare function useSpreadsheetCollaborationPresenceProjection({ content, workbook, }: {
+    content: WorkSpreadsheetContent;
+    workbook: WorkbookInstance | null;
+}): void;
+export declare function spreadsheetPresenceProjection(content: WorkSpreadsheetContent, participants: readonly WorkOfficeCollaborationParticipant[]): Presence[];