dsh-workspace-explorer 1.0.1 → 1.1.1

package/src/client/sidebar-motion.js

@@ -0,0 +1,69 @@
+const dockItems = ':is([data-dockkit-host="dock"], [data-dockkit-empty], [data-dockkit-divider])';
+const toggleButtons = 'button:is([data-sidebar-right-expand], [data-sidebar-right-toggle])';
+
+export function installSidebarMotion(sidebar) {
+  let allowed;
+  let collectFrame;
+  const instantFrames = new Map();
+
+  function stopMotion() {
+    cancelAnimationFrame(collectFrame);
+    if (!allowed) return;
+    for (const item of allowed.items) delete item.dataset.dweSidebarToggleMotion;
+    allowed = undefined;
+  }
+
+  function allowButtonMotion(event) {
+    const button = event.target instanceof Element && event.target.closest(toggleButtons);
+    if (!button || button.disabled) return;
+    const sessionId = sidebar.mounted.getSnapshot();
+    const panel = sessionId && document.querySelector(
+      '[data-sidebar-right-panel][data-sidebar-right-session="' + CSS.escape(sessionId) + '"]',
+    );
+    const frame = panel?.closest('[data-rightbar-col]')?.parentElement;
+    if (!frame) return;
+
+    // A tab selected during the slide must not inherit permission to animate.
+    stopMotion();
+    const items = [...panel.querySelectorAll(dockItems + ':not([hidden])')];
+    const motion = { frame, items };
+    allowed = motion;
+    for (const item of items) item.dataset.dweSidebarToggleMotion = '';
+    collectFrame = requestAnimationFrame(() => {
+      const transitions = [...frame.getAnimations(), ...items.flatMap(item => item.getAnimations())]
+        .filter(animation => ['transform', 'grid-template-columns'].includes(animation.transitionProperty));
+      Promise.allSettled(transitions.map(animation => animation.finished)).then(() => {
+        if (allowed === motion) stopMotion();
+      });
+    });
+  }
+
+  // The shell shares one grid transition between the left and right columns.
+  // Snap right-track changes outside the toggle controls so the left controls still animate.
+  const track = new MutationObserver(records => {
+    for (const frame of new Set(records.map(record => record.target))) {
+      if (allowed?.frame === frame || !frame.querySelector(':scope > [data-rightbar-col]')) continue;
+      cancelAnimationFrame(instantFrames.get(frame));
+      frame.dataset.dweSidebarTrackInstant = '';
+      instantFrames.set(frame, requestAnimationFrame(() => {
+        instantFrames.set(frame, requestAnimationFrame(() => {
+          delete frame.dataset.dweSidebarTrackInstant;
+          instantFrames.delete(frame);
+        }));
+      }));
+    }
+  });
+  track.observe(document.documentElement, { subtree: true, attributeFilter: ['data-rightbar-collapsed'] });
+  document.addEventListener('click', allowButtonMotion, true);
+  const disposeSwitch = sidebar.mounted.subscribe(stopMotion);
+  return () => {
+    stopMotion();
+    disposeSwitch();
+    track.disconnect();
+    for (const [frame, request] of instantFrames) {
+      cancelAnimationFrame(request);
+      delete frame.dataset.dweSidebarTrackInstant;
+    }
+    document.removeEventListener('click', allowButtonMotion, true);
+  };
+}

package/src/document-types.js

@@ -0,0 +1,2 @@
+export const officeExtensions = new Set(['doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx']);
+export const pdfAssetsPath = '/api/dsh.workspaceExplorer/pdf';

package/src/host/ExplorerShell.cs

@@ -1,184 +1,184 @@
-using System;
-using System.Runtime.InteropServices;
-
-public static class ExplorerShell {
-    [DllImport("shell32.dll", CharSet = CharSet.Unicode, PreserveSig = false)]
-    private static extern IShellItem SHCreateItemFromParsingName(string path, IntPtr binding, [MarshalAs(UnmanagedType.LPStruct)] Guid iid);
-
-    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
-    private static extern bool MoveFileEx(string source, string destination, uint flags);
-
-    [DllImport("user32.dll")]
-    public static extern uint GetClipboardSequenceNumber();
-
-    [DllImport("user32.dll")]
-    private static extern bool OpenClipboard(IntPtr window);
-
-    [DllImport("user32.dll")]
-    private static extern bool CloseClipboard();
-
-    [DllImport("user32.dll")]
-    private static extern bool EmptyClipboard();
-
-    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
-    private static extern uint RegisterClipboardFormat(string format);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetClipboardData(uint format);
-
-    [DllImport("kernel32.dll")]
-    private static extern IntPtr GlobalLock(IntPtr memory);
-
-    [DllImport("kernel32.dll")]
-    private static extern bool GlobalUnlock(IntPtr memory);
-
-    [DllImport("kernel32.dll")]
-    private static extern UIntPtr GlobalSize(IntPtr memory);
-
-    public static bool ClipboardIsCut() {
-        if (!OpenClipboard(IntPtr.Zero)) throw new InvalidOperationException("Clipboard unavailable");
-        try {
-            IntPtr memory = GetClipboardData(RegisterClipboardFormat("Preferred DropEffect"));
-            if (memory == IntPtr.Zero || GlobalSize(memory).ToUInt64() < 4) return false;
-            IntPtr data = GlobalLock(memory);
-            if (data == IntPtr.Zero) return false;
-            try { return (Marshal.ReadInt32(data) & 2) != 0; }
-            finally { GlobalUnlock(memory); }
-        } finally { CloseClipboard(); }
-    }
-
-    public static int Rename(string source, string destination) {
-        return MoveFileEx(source, destination, 0) ? 0 : Marshal.GetLastWin32Error();
-    }
-
-    public static void ClearClipboardIfUnchanged(uint sequence) {
-        if (!OpenClipboard(IntPtr.Zero)) return;
-        try {
-            if (sequence == GetClipboardSequenceNumber()) EmptyClipboard();
-        } finally { CloseClipboard(); }
-    }
-
-    public static bool Transfer(string source, string destination, bool cut) {
-        IFileOperation operation = (IFileOperation)new FileOperation();
-        try {
-            const uint silent = 0x4, keepBoth = 0x8, noConfirmation = 0x10;
-            const uint noErrorUI = 0x400, onlySelected = 0x2000, earlyFailure = 0x100000;
-            const uint keepExtension = 0x200000, noCopyHooks = 0x800000, undoRecord = 0x20000000;
-            operation.SetOperationFlags(silent | keepBoth | noConfirmation | noErrorUI | onlySelected
-                | earlyFailure | keepExtension | noCopyHooks | undoRecord);
-            Guid iid = typeof(IShellItem).GUID;
-            IShellItem item = SHCreateItemFromParsingName(source, IntPtr.Zero, iid);
-            try {
-                IShellItem folder = SHCreateItemFromParsingName(destination, IntPtr.Zero, iid);
-                try {
-                    if (cut) operation.MoveItem(item, folder, null, IntPtr.Zero);
-                    else operation.CopyItem(item, folder, null, IntPtr.Zero);
-                    operation.PerformOperations();
-                    return !operation.GetAnyOperationsAborted();
-                } finally { Marshal.ReleaseComObject(folder); }
-            } finally { Marshal.ReleaseComObject(item); }
-        } finally { Marshal.ReleaseComObject(operation); }
-    }
-
-    public static bool Recycle(string source) {
-        IFileOperation operation = (IFileOperation)new FileOperation();
-        try {
-            const uint silent = 0x4, noConfirmation = 0x10, allowUndo = 0x40, noErrorUI = 0x400;
-            const uint onlySelected = 0x2000, warnPermanent = 0x4000, recycle = 0x80000;
-            const uint earlyFailure = 0x100000, noCopyHooks = 0x800000, undoRecord = 0x20000000;
-            operation.SetOperationFlags(silent | noConfirmation | allowUndo | noErrorUI | onlySelected | warnPermanent
-                | recycle | earlyFailure | noCopyHooks | undoRecord);
-            IShellItem item = SHCreateItemFromParsingName(source, IntPtr.Zero, typeof(IShellItem).GUID);
-            try {
-                RecycleOnly sink = new RecycleOnly();
-                operation.DeleteItem(item, sink);
-                operation.PerformOperations();
-                return sink.Recycled && !operation.GetAnyOperationsAborted();
-            } finally { Marshal.ReleaseComObject(item); }
-        } finally { Marshal.ReleaseComObject(operation); }
-    }
-
-    [ComImport, Guid("3AD05575-8857-4850-9277-11B85BDB8E09")]
-    private class FileOperation { }
-
-    [ComImport, Guid("43826D1E-E718-42EE-BC55-A1E261C37BFE"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
-    public interface IShellItem { }
-
-    // Keep the declaration in the native IFileOperation vtable order.
-    [ComImport, Guid("947AAB5F-0A5C-4C13-B4D6-4BF7836FC9F8"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
-    private interface IFileOperation {
-        void Advise(IntPtr sink, out uint cookie);
-        void Unadvise(uint cookie);
-        void SetOperationFlags(uint flags);
-        void SetProgressMessage([MarshalAs(UnmanagedType.LPWStr)] string message);
-        void SetProgressDialog(IntPtr dialog);
-        void SetProperties(IntPtr properties);
-        void SetOwnerWindow(IntPtr window);
-        void ApplyPropertiesToItem(IShellItem item);
-        void ApplyPropertiesToItems(IntPtr items);
-        void RenameItem(IShellItem item, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
-        void RenameItems(IntPtr items, [MarshalAs(UnmanagedType.LPWStr)] string name);
-        void MoveItem(IShellItem item, IShellItem destination, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
-        void MoveItems(IntPtr items, IShellItem destination);
-        void CopyItem(IShellItem item, IShellItem destination, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
-        void CopyItems(IntPtr items, IShellItem destination);
-        void DeleteItem(IShellItem item, IFileOperationProgressSink sink);
-        void DeleteItems(IntPtr items);
-        void NewItem(IShellItem destination, uint attributes, [MarshalAs(UnmanagedType.LPWStr)] string name,
-            [MarshalAs(UnmanagedType.LPWStr)] string template, IntPtr sink);
-        void PerformOperations();
-        [return: MarshalAs(UnmanagedType.Bool)]
-        bool GetAnyOperationsAborted();
-    }
-
-    [ComImport, Guid("04B0F1A7-9490-44BC-96E1-4296A31252E2"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
-    public interface IFileOperationProgressSink {
-        [PreserveSig] int StartOperations();
-        [PreserveSig] int FinishOperations(int result);
-        [PreserveSig] int PreRenameItem(uint flags, IShellItem item, IntPtr name);
-        [PreserveSig] int PostRenameItem(uint flags, IShellItem item, IntPtr name, int result, IShellItem created);
-        [PreserveSig] int PreMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name);
-        [PreserveSig] int PostMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created);
-        [PreserveSig] int PreCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name);
-        [PreserveSig] int PostCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created);
-        [PreserveSig] int PreDeleteItem(uint flags, IShellItem item);
-        [PreserveSig] int PostDeleteItem(uint flags, IShellItem item, int result, IShellItem created);
-        [PreserveSig] int PreNewItem(uint flags, IShellItem folder, IntPtr name);
-        [PreserveSig] int PostNewItem(uint flags, IShellItem folder, IntPtr name, IntPtr template, uint attrs, int result, IShellItem created);
-        [PreserveSig] int UpdateProgress(uint total, uint completed);
-        [PreserveSig] int ResetTimer();
-        [PreserveSig] int PauseTimer();
-        [PreserveSig] int ResumeTimer();
-    }
-
-    [ComVisible(true), ClassInterface(ClassInterfaceType.None)]
-    public sealed class RecycleOnly : IFileOperationProgressSink {
-        public bool Recycled { get; private set; }
-
-        public int PreDeleteItem(uint flags, IShellItem item) {
-            const uint recycleIfPossible = 0x80;
-            const int cancelled = unchecked((int)0x800704C7);
-            return (flags & recycleIfPossible) != 0 ? 0 : cancelled;
-        }
-
-        public int PostDeleteItem(uint flags, IShellItem item, int result, IShellItem created) {
-            Recycled = result >= 0 && created != null;
-            return 0;
-        }
-
-        public int StartOperations() { return 0; }
-        public int FinishOperations(int result) { return 0; }
-        public int PreRenameItem(uint flags, IShellItem item, IntPtr name) { return 0; }
-        public int PostRenameItem(uint flags, IShellItem item, IntPtr name, int result, IShellItem created) { return 0; }
-        public int PreMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name) { return 0; }
-        public int PostMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created) { return 0; }
-        public int PreCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name) { return 0; }
-        public int PostCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created) { return 0; }
-        public int PreNewItem(uint flags, IShellItem folder, IntPtr name) { return 0; }
-        public int PostNewItem(uint flags, IShellItem folder, IntPtr name, IntPtr template, uint attrs, int result, IShellItem created) { return 0; }
-        public int UpdateProgress(uint total, uint completed) { return 0; }
-        public int ResetTimer() { return 0; }
-        public int PauseTimer() { return 0; }
-        public int ResumeTimer() { return 0; }
-    }
+using System;
+using System.Runtime.InteropServices;
+
+public static class ExplorerShell {
+    [DllImport("shell32.dll", CharSet = CharSet.Unicode, PreserveSig = false)]
+    private static extern IShellItem SHCreateItemFromParsingName(string path, IntPtr binding, [MarshalAs(UnmanagedType.LPStruct)] Guid iid);
+
+    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    private static extern bool MoveFileEx(string source, string destination, uint flags);
+
+    [DllImport("user32.dll")]
+    public static extern uint GetClipboardSequenceNumber();
+
+    [DllImport("user32.dll")]
+    private static extern bool OpenClipboard(IntPtr window);
+
+    [DllImport("user32.dll")]
+    private static extern bool CloseClipboard();
+
+    [DllImport("user32.dll")]
+    private static extern bool EmptyClipboard();
+
+    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
+    private static extern uint RegisterClipboardFormat(string format);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetClipboardData(uint format);
+
+    [DllImport("kernel32.dll")]
+    private static extern IntPtr GlobalLock(IntPtr memory);
+
+    [DllImport("kernel32.dll")]
+    private static extern bool GlobalUnlock(IntPtr memory);
+
+    [DllImport("kernel32.dll")]
+    private static extern UIntPtr GlobalSize(IntPtr memory);
+
+    public static bool ClipboardIsCut() {
+        if (!OpenClipboard(IntPtr.Zero)) throw new InvalidOperationException("Clipboard unavailable");
+        try {
+            IntPtr memory = GetClipboardData(RegisterClipboardFormat("Preferred DropEffect"));
+            if (memory == IntPtr.Zero || GlobalSize(memory).ToUInt64() < 4) return false;
+            IntPtr data = GlobalLock(memory);
+            if (data == IntPtr.Zero) return false;
+            try { return (Marshal.ReadInt32(data) & 2) != 0; }
+            finally { GlobalUnlock(memory); }
+        } finally { CloseClipboard(); }
+    }
+
+    public static int Rename(string source, string destination) {
+        return MoveFileEx(source, destination, 0) ? 0 : Marshal.GetLastWin32Error();
+    }
+
+    public static void ClearClipboardIfUnchanged(uint sequence) {
+        if (!OpenClipboard(IntPtr.Zero)) return;
+        try {
+            if (sequence == GetClipboardSequenceNumber()) EmptyClipboard();
+        } finally { CloseClipboard(); }
+    }
+
+    public static bool Transfer(string source, string destination, bool cut) {
+        IFileOperation operation = (IFileOperation)new FileOperation();
+        try {
+            const uint silent = 0x4, keepBoth = 0x8, noConfirmation = 0x10;
+            const uint noErrorUI = 0x400, onlySelected = 0x2000, earlyFailure = 0x100000;
+            const uint keepExtension = 0x200000, noCopyHooks = 0x800000, undoRecord = 0x20000000;
+            operation.SetOperationFlags(silent | keepBoth | noConfirmation | noErrorUI | onlySelected
+                | earlyFailure | keepExtension | noCopyHooks | undoRecord);
+            Guid iid = typeof(IShellItem).GUID;
+            IShellItem item = SHCreateItemFromParsingName(source, IntPtr.Zero, iid);
+            try {
+                IShellItem folder = SHCreateItemFromParsingName(destination, IntPtr.Zero, iid);
+                try {
+                    if (cut) operation.MoveItem(item, folder, null, IntPtr.Zero);
+                    else operation.CopyItem(item, folder, null, IntPtr.Zero);
+                    operation.PerformOperations();
+                    return !operation.GetAnyOperationsAborted();
+                } finally { Marshal.ReleaseComObject(folder); }
+            } finally { Marshal.ReleaseComObject(item); }
+        } finally { Marshal.ReleaseComObject(operation); }
+    }
+
+    public static bool Recycle(string source) {
+        IFileOperation operation = (IFileOperation)new FileOperation();
+        try {
+            const uint silent = 0x4, noConfirmation = 0x10, allowUndo = 0x40, noErrorUI = 0x400;
+            const uint onlySelected = 0x2000, warnPermanent = 0x4000, recycle = 0x80000;
+            const uint earlyFailure = 0x100000, noCopyHooks = 0x800000, undoRecord = 0x20000000;
+            operation.SetOperationFlags(silent | noConfirmation | allowUndo | noErrorUI | onlySelected | warnPermanent
+                | recycle | earlyFailure | noCopyHooks | undoRecord);
+            IShellItem item = SHCreateItemFromParsingName(source, IntPtr.Zero, typeof(IShellItem).GUID);
+            try {
+                RecycleOnly sink = new RecycleOnly();
+                operation.DeleteItem(item, sink);
+                operation.PerformOperations();
+                return sink.Recycled && !operation.GetAnyOperationsAborted();
+            } finally { Marshal.ReleaseComObject(item); }
+        } finally { Marshal.ReleaseComObject(operation); }
+    }
+
+    [ComImport, Guid("3AD05575-8857-4850-9277-11B85BDB8E09")]
+    private class FileOperation { }
+
+    [ComImport, Guid("43826D1E-E718-42EE-BC55-A1E261C37BFE"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface IShellItem { }
+
+    // Keep the declaration in the native IFileOperation vtable order.
+    [ComImport, Guid("947AAB5F-0A5C-4C13-B4D6-4BF7836FC9F8"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    private interface IFileOperation {
+        void Advise(IntPtr sink, out uint cookie);
+        void Unadvise(uint cookie);
+        void SetOperationFlags(uint flags);
+        void SetProgressMessage([MarshalAs(UnmanagedType.LPWStr)] string message);
+        void SetProgressDialog(IntPtr dialog);
+        void SetProperties(IntPtr properties);
+        void SetOwnerWindow(IntPtr window);
+        void ApplyPropertiesToItem(IShellItem item);
+        void ApplyPropertiesToItems(IntPtr items);
+        void RenameItem(IShellItem item, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
+        void RenameItems(IntPtr items, [MarshalAs(UnmanagedType.LPWStr)] string name);
+        void MoveItem(IShellItem item, IShellItem destination, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
+        void MoveItems(IntPtr items, IShellItem destination);
+        void CopyItem(IShellItem item, IShellItem destination, [MarshalAs(UnmanagedType.LPWStr)] string name, IntPtr sink);
+        void CopyItems(IntPtr items, IShellItem destination);
+        void DeleteItem(IShellItem item, IFileOperationProgressSink sink);
+        void DeleteItems(IntPtr items);
+        void NewItem(IShellItem destination, uint attributes, [MarshalAs(UnmanagedType.LPWStr)] string name,
+            [MarshalAs(UnmanagedType.LPWStr)] string template, IntPtr sink);
+        void PerformOperations();
+        [return: MarshalAs(UnmanagedType.Bool)]
+        bool GetAnyOperationsAborted();
+    }
+
+    [ComImport, Guid("04B0F1A7-9490-44BC-96E1-4296A31252E2"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    public interface IFileOperationProgressSink {
+        [PreserveSig] int StartOperations();
+        [PreserveSig] int FinishOperations(int result);
+        [PreserveSig] int PreRenameItem(uint flags, IShellItem item, IntPtr name);
+        [PreserveSig] int PostRenameItem(uint flags, IShellItem item, IntPtr name, int result, IShellItem created);
+        [PreserveSig] int PreMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name);
+        [PreserveSig] int PostMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created);
+        [PreserveSig] int PreCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name);
+        [PreserveSig] int PostCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created);
+        [PreserveSig] int PreDeleteItem(uint flags, IShellItem item);
+        [PreserveSig] int PostDeleteItem(uint flags, IShellItem item, int result, IShellItem created);
+        [PreserveSig] int PreNewItem(uint flags, IShellItem folder, IntPtr name);
+        [PreserveSig] int PostNewItem(uint flags, IShellItem folder, IntPtr name, IntPtr template, uint attrs, int result, IShellItem created);
+        [PreserveSig] int UpdateProgress(uint total, uint completed);
+        [PreserveSig] int ResetTimer();
+        [PreserveSig] int PauseTimer();
+        [PreserveSig] int ResumeTimer();
+    }
+
+    [ComVisible(true), ClassInterface(ClassInterfaceType.None)]
+    public sealed class RecycleOnly : IFileOperationProgressSink {
+        public bool Recycled { get; private set; }
+
+        public int PreDeleteItem(uint flags, IShellItem item) {
+            const uint recycleIfPossible = 0x80;
+            const int cancelled = unchecked((int)0x800704C7);
+            return (flags & recycleIfPossible) != 0 ? 0 : cancelled;
+        }
+
+        public int PostDeleteItem(uint flags, IShellItem item, int result, IShellItem created) {
+            Recycled = result >= 0 && created != null;
+            return 0;
+        }
+
+        public int StartOperations() { return 0; }
+        public int FinishOperations(int result) { return 0; }
+        public int PreRenameItem(uint flags, IShellItem item, IntPtr name) { return 0; }
+        public int PostRenameItem(uint flags, IShellItem item, IntPtr name, int result, IShellItem created) { return 0; }
+        public int PreMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name) { return 0; }
+        public int PostMoveItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created) { return 0; }
+        public int PreCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name) { return 0; }
+        public int PostCopyItem(uint flags, IShellItem item, IShellItem folder, IntPtr name, int result, IShellItem created) { return 0; }
+        public int PreNewItem(uint flags, IShellItem folder, IntPtr name) { return 0; }
+        public int PostNewItem(uint flags, IShellItem folder, IntPtr name, IntPtr template, uint attrs, int result, IShellItem created) { return 0; }
+        public int UpdateProgress(uint total, uint completed) { return 0; }
+        public int ResetTimer() { return 0; }
+        public int PauseTimer() { return 0; }
+        public int ResumeTimer() { return 0; }
+    }
 }

package/src/host/files.js

@@ -4,8 +4,10 @@ import { lstat, open, opendir, readlink, realpath, stat } from 'node:fs/promises
 import { win32 as path } from 'node:path';
 import { Readable } from 'node:stream';
 import { promisify } from 'node:util';
+import { officeExtensions } from '../document-types.js';
 import { thumbnailType } from '../thumbnail-types.js';
 import { underPath } from '../ui/navigation.js';
+import { registerPdfAssets } from './pdf-assets.js';
 import { windowsFileOperation } from './shell-files.js';
 
 const execute = promisify(execFile);
@@ -50,6 +52,21 @@ function operationPaths(input) {
   return [...new Set(paths.map(normalizeLocalPath))];
 }
 
+function fileVersion(info) {
+  return JSON.stringify([info.dev, info.ino, info.size, info.mtimeMs, info.ctimeMs]);
+}
+
+function decodePreviewText(data, eof) {
+  let text;
+  try {
+    text = new TextDecoder('utf-8', { fatal: true }).decode(data, { stream: !eof });
+  } catch {
+    throw new BrowseError('此文件不是 UTF-8 文本');
+  }
+  if (text.includes('\0')) throw new BrowseError('此格式没有可用的文本预览');
+  return text;
+}
+
 async function scanDrives() {
   const powershell = path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
   const command = "[System.IO.DriveInfo]::GetDrives() | Where-Object { $_.DriveType -in 'Fixed','Removable','CDRom','Ram' } | ForEach-Object { $_.Name }";
@@ -205,7 +222,7 @@ function createDiskAccess() {
     return { matches, truncated: false, skipped };
   }
 
-  async function read(input, limit, signal, workspace) {
+  async function read(input, limit, signal, workspace, { version, sniffText } = {}) {
     const target = await resolve(input, signal, workspace);
     const info = await stat(target);
     if (!info.isFile()) throw new BrowseError('只能预览普通文件');
@@ -214,28 +231,57 @@ function createDiskAccess() {
     try {
       const opened = await handle.stat();
       if (!opened.isFile()) throw new BrowseError('只能预览普通文件');
+      if (version && fileVersion(opened) !== version) throw new BrowseError('文件已改变，请重新预览', 409);
       const buffer = Buffer.allocUnsafe(Math.min(opened.size, limit) + 1);
       let length = 0;
       while (length < buffer.length) {
         signal.throwIfAborted();
-        const { bytesRead } = await handle.read(buffer, length, buffer.length - length, length);
+        const readSize = sniffText && length === 0 ? Math.min(4096, buffer.length) : buffer.length - length;
+        const { bytesRead } = await handle.read(buffer, length, readSize, length);
         if (!bytesRead) break;
+        if (sniffText && length === 0) decodePreviewText(buffer.subarray(0, bytesRead), false);
         length += bytesRead;
       }
       const eof = length <= limit && length <= opened.size;
       if (limit === maxBytes && (!eof || opened.size > limit)) throw new BrowseError('文件超过 32 MB 读取上限', 413);
+      if (version && (!eof || fileVersion(await handle.stat()) !== version)) {
+        throw new BrowseError('文件已改变，请重新预览', 409);
+      }
       return { data: buffer.subarray(0, Math.min(length, limit)), eof };
     } finally {
       await handle.close();
     }
   }
 
+  async function renderOffice(input, signal, workspace, converter) {
+    const absolute = normalizeLocalPath(input);
+    const extension = path.extname(absolute).slice(1).toLowerCase();
+    if (!officeExtensions.has(extension)) throw new BrowseError('不是可预览的 Office 格式');
+    const target = await resolve(absolute, signal, workspace);
+    const info = await stat(target);
+    if (!info.isFile()) throw new BrowseError('只能预览普通文件');
+    if (info.size > maxBytes) throw new BrowseError('文件超过 32 MB 读取上限', 413);
+    const version = fileVersion(info);
+    const result = await converter.convert({
+      extension, priority: 'foreground',
+      source: {
+        key: JSON.stringify(['dsh-workspace-explorer', workspace?.nativeRoot, target]),
+        version, bytes: info.size,
+        read: async (readSignal, budget) => {
+          const { data } = await read(absolute, Math.min(budget, maxBytes), readSignal, workspace, { version });
+          return { bytes: data, version };
+        },
+      },
+    }, signal);
+    return result.pdf;
+  }
+
   async function locate(input, signal, workspace) {
     const absolute = normalizeLocalPath(input);
     const target = await resolve(absolute, signal, workspace);
     const info = await stat(target);
     if (info.isDirectory()) return { path: absolute, nativePath: target, type: 'directory' };
-    if (info.isFile()) return { path: absolute, nativePath: target, type: 'file', name: path.basename(absolute) };
+    if (info.isFile()) return { path: absolute, nativePath: target, type: 'file', name: path.basename(absolute), size: info.size };
     throw new BrowseError('该路径不指向普通文件或文件夹');
   }
 
@@ -401,7 +447,7 @@ function createDiskAccess() {
     }
   }
 
-  return { list, read, locate, thumbnail, stage, rename, paste, recycle, scope, search };
+  return { list, read, renderOffice, locate, thumbnail, stage, rename, paste, recycle, scope, search };
 }
 
 function byteRange(value, size) {
@@ -428,6 +474,7 @@ function json(value, status = 200) {
 
 export function registerDesktopFiles(ctx) {
   const disks = createDiskAccess();
+  registerPdfAssets(ctx);
   let writes = Promise.resolve();
   function write(action) {
     const result = writes.then(action);
@@ -513,20 +560,18 @@ export function registerDesktopFiles(ctx) {
           return json({ url: thumbnailEndpoint + '?ticket=' + token });
         }
         if (operation === 'text') {
-          const { data, eof } = await disks.read(input, maxText, signal, workspace);
-          let text;
-          try {
-            text = new TextDecoder('utf-8', { fatal: true }).decode(data, { stream: !eof });
-          } catch {
-            throw new BrowseError('此文件不是 UTF-8 文本');
-          }
-          if (text.includes('\0')) throw new BrowseError('此格式没有可用的文本预览');
-          return json({ text, eof });
+          const { data, eof } = await disks.read(input, maxText, signal, workspace, { sniffText: true });
+          return json({ text: decodePreviewText(data, eof), eof });
         }
-        if (operation === 'bytes') {
-          const { data } = await disks.read(input, maxBytes, signal, workspace);
+        if (operation === 'bytes' || operation === 'office') {
+          const converter = operation === 'office' ? ctx.officeToPdf : undefined;
+          if (operation === 'office' && !converter) return json({ error: '当前 DSH 未提供 Office 转换服务' }, 503);
+          const data = converter
+            ? await disks.renderOffice(input, signal, workspace, converter)
+            : (await disks.read(input, maxBytes, signal, workspace)).data;
           return new Response(data, { headers: {
-            'content-type': 'application/octet-stream', 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
+            'content-type': converter ? 'application/pdf' : 'application/octet-stream',
+            'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
           } });
         }
         throw new BrowseError('无效的文件操作');

package/src/host/pdf-assets.js

@@ -0,0 +1,30 @@
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { pdfAssetsPath } from '../document-types.js';
+
+const require = createRequire(import.meta.url);
+const assetName = /^(?:build\/pdf(?:\.worker)?\.min\.mjs|cmaps\/[\w.-]+\.bcmap|standard_fonts\/[\w.-]+\.(?:pfb|ttf)|wasm\/[\w.-]+\.(?:wasm|js))$/;
+
+export function registerPdfAssets(ctx) {
+  ctx.connection.fetch.register({
+    path: pdfAssetsPath,
+    methods: ['GET'],
+    requestBody: 'buffered',
+    async fetch(request) {
+      const file = new URL(request.url).searchParams.get('file');
+      if (!file || !assetName.test(file)) return new Response(null, { status: 404 });
+      try {
+        const root = dirname(require.resolve('pdfjs-dist/package.json'));
+        const data = await readFile(join(root, file));
+        const contentType = file.endsWith('.wasm') ? 'application/wasm'
+          : /\.m?js$/.test(file) ? 'text/javascript' : 'application/octet-stream';
+        return new Response(data, { headers: {
+          'content-type': contentType, 'x-content-type-options': 'nosniff', 'cache-control': 'no-store',
+        } });
+      } catch {
+        return new Response(null, { status: 404 });
+      }
+    },
+  });
+}