@a3s-lab/office 0.2.2 → 0.4.0

package/dist/432.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { Suspense, lazy } from "react";
+import { Suspense, createContext, lazy, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 import { LoaderCircle } from "lucide-react";
+import { OfficeCollaborationError as WorkOfficeCollaborationError } from "./9787.js";
 function StateView({ icon, title, description, descriptionTitle, actions, children, tone = 'neutral', size = 'standard', role, className = '' }) {
     return /*#__PURE__*/ jsxs("div", {
         className: `ds-state-view ${tone} ${size}${className ? ` ${className}` : ''}`,
@@ -40,6 +41,136 @@ function WorkEditorLoadingState({ title }) {
         title: title
     });
 }
+const OfficeCollaborationPresenceContext = /*#__PURE__*/ createContext(null);
+function OfficeCollaborationPresenceProvider({ children, presence }) {
+    const navigatorRef = useRef(null);
+    const registerLocationNavigator = useCallback((navigator)=>{
+        navigatorRef.current = navigator;
+        return ()=>{
+            if (navigatorRef.current === navigator) navigatorRef.current = null;
+        };
+    }, []);
+    const navigateToParticipant = useCallback((participant)=>navigatorRef.current?.(participant) ?? false, []);
+    const value = useMemo(()=>({
+            navigateToParticipant,
+            presence,
+            registerLocationNavigator
+        }), [
+        navigateToParticipant,
+        presence,
+        registerLocationNavigator
+    ]);
+    return /*#__PURE__*/ jsx(OfficeCollaborationPresenceContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+function useOfficeCollaborationPresence() {
+    return useContext(OfficeCollaborationPresenceContext)?.presence;
+}
+function useOfficeCollaborationLocationNavigator(navigator) {
+    const context = useContext(OfficeCollaborationPresenceContext);
+    useEffect(()=>{
+        if (!context?.presence) return;
+        return context.registerLocationNavigator(navigator);
+    }, [
+        context,
+        navigator
+    ]);
+}
+function useOfficeCollaborationParticipantNavigation() {
+    const context = useContext(OfficeCollaborationPresenceContext);
+    return context?.presence ? context.navigateToParticipant : void 0;
+}
+function assertOfficeCollaborationPresencePairing({ expectedKind, presence, session }) {
+    if (!presence) return;
+    if (!session) throw new WorkOfficeCollaborationError('office.collaboration.presence_invalid', 'Office editor presence must be paired with its collaboration session.');
+    const local = presence.local();
+    if (session.kind !== expectedKind || local.artifactKind !== expectedKind) throw new WorkOfficeCollaborationError('office.collaboration.kind_mismatch', `Office editor presence and collaboration must both target '${expectedKind}'.`);
+    if (local.artifactId !== session.artifactId) throw new WorkOfficeCollaborationError('office.collaboration.artifact_mismatch', 'Office editor presence belongs to another collaboration artifact.');
+    const snapshot = presence.snapshot();
+    const actor = session.actor;
+    if (local.namespace !== session.namespace || snapshot.localClientId !== session.document.clientID || !actor || local.actor.id !== actor.id || local.actor.kind !== (actor.kind ?? 'human') || local.mode !== session.mode) throw new WorkOfficeCollaborationError('office.collaboration.presence_invalid', 'Office editor presence does not belong to the supplied collaboration session.');
+}
+const OFFICE_EDITOR_INITIAL_FOCUS_MAX_FRAMES = 120;
+const OfficeEditorFocusOriginContext = /*#__PURE__*/ createContext(void 0);
+function OfficeEditorFocusHandoff({ children }) {
+    const originRef = useRef(void 0);
+    if (void 0 === originRef.current) originRef.current = activeFocusOrigin();
+    return /*#__PURE__*/ jsx(OfficeEditorFocusOriginContext.Provider, {
+        value: originRef.current,
+        children: children
+    });
+}
+function useOfficeEditorFocusOrigin() {
+    const handedOffOrigin = useContext(OfficeEditorFocusOriginContext);
+    const localOriginRef = useRef(void 0);
+    if (void 0 === localOriginRef.current) localOriginRef.current = activeFocusOrigin();
+    return void 0 === handedOffOrigin ? localOriginRef.current : handedOffOrigin;
+}
+function useOfficeEditorInitialFocus({ enabled, getTarget, isTargetReady }) {
+    const focusOrigin = useOfficeEditorFocusOrigin();
+    const getTargetRef = useRef(getTarget);
+    const isTargetReadyRef = useRef(isTargetReady);
+    getTargetRef.current = getTarget;
+    isTargetReadyRef.current = isTargetReady;
+    useEffect(()=>{
+        if (!enabled) return;
+        return stabilizeOfficeEditorInitialFocus(()=>getTargetRef.current(), focusOrigin, (target)=>isTargetReadyRef.current?.(target) ?? true);
+    }, [
+        enabled,
+        focusOrigin
+    ]);
+}
+function stabilizeOfficeEditorInitialFocus(getTarget, focusOrigin = activeFocusOrigin(), isTargetReady = ()=>true) {
+    if ("u" < typeof document || 'function' != typeof requestAnimationFrame || 'function' != typeof cancelAnimationFrame) return ()=>void 0;
+    let frame = 0;
+    let remainingFrames = OFFICE_EDITOR_INITIAL_FOCUS_MAX_FRAMES;
+    let lastTarget = null;
+    let stopped = false;
+    const stop = ()=>{
+        if (stopped) return;
+        stopped = true;
+        if (frame) cancelAnimationFrame(frame);
+        document.removeEventListener('pointerdown', handleOutsideInteraction, true);
+        document.removeEventListener('click', handleOutsideInteraction, true);
+        document.removeEventListener('keydown', handleKeyDown, true);
+    };
+    const handleOutsideInteraction = (event)=>{
+        const target = getTarget();
+        if (event.target instanceof Node && target?.isConnected && target.contains(event.target)) return;
+        stop();
+    };
+    const handleKeyDown = (event)=>{
+        if ('Tab' === event.key) stop();
+    };
+    const canClaimFocus = (activeElement, target)=>activeElement === focusOrigin || activeElement === document.body || activeElement === document.documentElement || !activeElement?.isConnected || Boolean(target?.contains(activeElement)) || Boolean(lastTarget?.contains(activeElement));
+    const stabilize = ()=>{
+        frame = 0;
+        if (stopped || remainingFrames <= 0) return void stop();
+        remainingFrames -= 1;
+        const target = getTarget();
+        const activeElement = document.activeElement;
+        if (!canClaimFocus(activeElement, target)) return void stop();
+        if (target?.isConnected && isTargetReady(target)) {
+            const targetAlreadyFocused = target.contains(activeElement);
+            if (!targetAlreadyFocused) target.focus({
+                preventScroll: true
+            });
+            if (target.contains(document.activeElement)) lastTarget = target;
+        }
+        frame = requestAnimationFrame(stabilize);
+    };
+    document.addEventListener('pointerdown', handleOutsideInteraction, true);
+    document.addEventListener('click', handleOutsideInteraction, true);
+    document.addEventListener('keydown', handleKeyDown, true);
+    frame = requestAnimationFrame(stabilize);
+    return stop;
+}
+function activeFocusOrigin() {
+    return "u" < typeof document ? null : document.activeElement;
+}
+const PDF_EVIDENCE_COORDINATE_BASIS = 1000000;
 const OFFICE_DOCUMENT_LAYOUT_FONT_ID = 'noto-sans-hans-regular';
 const OFFICE_DOCUMENT_LAYOUT_FONT_FAMILY = 'A3S Office Noto Sans Hans';
 const OFFICE_DOCUMENT_LAYOUT_LATIN_FONT_ID = 'noto-sans-regular';
@@ -126,36 +257,53 @@ const defaultDocumentLayoutFonts = [
         style: 'normal'
     }
 ];
-function OfficeEditorLoader({ children, title }) {
-    return /*#__PURE__*/ jsx(Suspense, {
-        fallback: /*#__PURE__*/ jsx(WorkEditorLoadingState, {
-            title: title
-        }),
-        children: children
+function OfficeEditorLoader({ children, collaboration, kind, presence, title }) {
+    assertOfficeCollaborationPresencePairing({
+        expectedKind: kind,
+        presence,
+        session: collaboration
+    });
+    return /*#__PURE__*/ jsx(OfficeCollaborationPresenceProvider, {
+        presence: presence,
+        children: /*#__PURE__*/ jsx(OfficeEditorFocusHandoff, {
+            children: /*#__PURE__*/ jsx(Suspense, {
+                fallback: /*#__PURE__*/ jsx(WorkEditorLoadingState, {
+                    title: title
+                }),
+                children: children
+            })
+        })
     });
 }
-function DocumentEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmUrl, layoutFonts = defaultDocumentLayoutFonts, preview = false, style, theme, ...editorProps }) {
+function DocumentEditor({ className, defaultRibbonCollapsed = false, kernelWasmUrl = defaultOfficeKernelWasmUrl, layoutFonts = defaultDocumentLayoutFonts, presence, preview = false, style, theme, ...editorProps }) {
     return /*#__PURE__*/ jsx(OfficeSurface, {
         className: className,
         style: style,
         theme: theme,
         children: /*#__PURE__*/ jsx(OfficeEditorLoader, {
+            collaboration: editorProps.collaboration,
+            kind: "document",
+            presence: presence,
             title: "正在打开文字编辑器",
             children: /*#__PURE__*/ jsx(LazyDocumentEditor, {
                 ...editorProps,
                 kernelWasmUrl: kernelWasmUrl,
                 layoutFonts: layoutFonts,
-                preview: preview
+                preview: preview,
+                defaultRibbonCollapsed: defaultRibbonCollapsed
             })
         })
     });
 }
-function MarkdownEditor({ className, preview = false, style, theme, ...editorProps }) {
+function MarkdownEditor({ className, presence, preview = false, style, theme, ...editorProps }) {
     return /*#__PURE__*/ jsx(OfficeSurface, {
         className: className,
         style: style,
         theme: theme,
         children: /*#__PURE__*/ jsx(OfficeEditorLoader, {
+            collaboration: editorProps.collaboration,
+            kind: "markdown",
+            presence: presence,
             title: "正在打开 Markdown 编辑器",
             children: /*#__PURE__*/ jsx(LazyMarkdownEditor, {
                 ...editorProps,
@@ -164,12 +312,15 @@ function MarkdownEditor({ className, preview = false, style, theme, ...editorPro
         })
     });
 }
-function SpreadsheetEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmUrl, preview = false, style, theme, ...editorProps }) {
+function SpreadsheetEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmUrl, presence, preview = false, style, theme, ...editorProps }) {
     return /*#__PURE__*/ jsx(OfficeSurface, {
         className: className,
         style: style,
         theme: theme,
         children: /*#__PURE__*/ jsx(OfficeEditorLoader, {
+            collaboration: editorProps.collaboration,
+            kind: "spreadsheet",
+            presence: presence,
             title: "正在打开表格编辑器",
             children: /*#__PURE__*/ jsx(LazySpreadsheetEditor, {
                 ...editorProps,
@@ -179,12 +330,15 @@ function SpreadsheetEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmU
         })
     });
 }
-function PresentationEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmUrl, preview = false, style, theme, ...editorProps }) {
+function PresentationEditor({ className, kernelWasmUrl = defaultOfficeKernelWasmUrl, presence, preview = false, style, theme, ...editorProps }) {
     return /*#__PURE__*/ jsx(OfficeSurface, {
         className: className,
         style: style,
         theme: theme,
         children: /*#__PURE__*/ jsx(OfficeEditorLoader, {
+            collaboration: editorProps.collaboration,
+            kind: "presentation",
+            presence: presence,
             title: "正在打开演示编辑器",
             children: /*#__PURE__*/ jsx(LazyPresentationEditor, {
                 ...editorProps,
@@ -194,12 +348,15 @@ function PresentationEditor({ className, kernelWasmUrl = defaultOfficeKernelWasm
         })
     });
 }
-function PdfViewer({ className, style, theme, wasmUrl = defaultPdfiumWasmUrl, ...viewerProps }) {
+function PdfViewer({ className, presence, style, theme, wasmUrl = defaultPdfiumWasmUrl, ...viewerProps }) {
     return /*#__PURE__*/ jsx(OfficeSurface, {
         className: className,
         style: style,
         theme: theme,
         children: /*#__PURE__*/ jsx(OfficeEditorLoader, {
+            collaboration: viewerProps.collaboration,
+            kind: "pdf",
+            presence: presence,
             title: "正在打开 PDF",
             children: /*#__PURE__*/ jsx(LazyPdfViewer, {
                 ...viewerProps,
@@ -208,4 +365,4 @@ function PdfViewer({ className, style, theme, wasmUrl = defaultPdfiumWasmUrl, ..
         })
     });
 }
-export { DocumentEditor, MarkdownEditor, OFFICE_DOCUMENT_LAYOUT_ARABIC_FONT_ID, OFFICE_DOCUMENT_LAYOUT_FONT_ID, OFFICE_DOCUMENT_LAYOUT_HEBREW_FONT_ID, OFFICE_DOCUMENT_LAYOUT_LATIN_FONT_ID, PdfViewer, PresentationEditor, SpreadsheetEditor, StateView, WorkEditorLoadingState, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, documentLayoutFontKey, preloadOfficeEditor };
+export { DocumentEditor, MarkdownEditor, OFFICE_DOCUMENT_LAYOUT_ARABIC_FONT_ID, OFFICE_DOCUMENT_LAYOUT_FONT_ID, OFFICE_DOCUMENT_LAYOUT_HEBREW_FONT_ID, OFFICE_DOCUMENT_LAYOUT_LATIN_FONT_ID, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, StateView, WorkEditorLoadingState, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, documentLayoutFontKey, preloadOfficeEditor, useOfficeCollaborationLocationNavigator, useOfficeCollaborationParticipantNavigation, useOfficeCollaborationPresence, useOfficeEditorFocusOrigin, useOfficeEditorInitialFocus };