feat(xlsx-preview): add artifact spreadsheet preview

package.json

@@ -311,6 +311,7 @@
     "dotenv-cli": "^7.4.2",
     "drizzle-kit": "^0.31.4",
     "drizzle-orm": "^0.44.5",
+    "echarts": "^6.1.0",
     "electron": "41.8.0",
     "electron-builder": "26.15.3",
     "electron-devtools-installer": "^3.2.0",
@@ -332,8 +333,10 @@
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.1.4",
+    "exceljs": "^4.4.0",
     "fast-diff": "^1.3.0",
-    "fast-xml-parser": "5.4.1",
+    "fast-formula-parser": "^1.0.19",
+    "fast-xml-parser": "^5.4.1",
     "fetch-socks": "1.3.2",
     "form-data": "4.0.5",
     "fractional-indexing": "^3.2.0",
@@ -354,6 +357,7 @@
     "js-base64": "3.7.7",
     "json-schema": "0.4.0",
     "jsonc-parser": "^3.3.1",
+    "jszip": "^3.10.1",
     "katex": "0.16.22",
     "ky": "1.8.1",
     "linguist-languages": "^8.1.0",
@@ -369,6 +373,7 @@
     "nanoid": "3.3.11",
     "notion-helper": "^1.3.22",
     "npx-scope-finder": "^1.2.0",
+    "numfmt": "^3.2.6",
     "og-crd": "^0.0.2",
     "ollama-ai-provider-v2": "3.3.1",
     "open": "^8.4.2",

src/main/services/file/__tests__/watcher.test.ts

@@ -81,8 +81,9 @@ describe('createDirectoryWatcher', () => {
 
     const w = createDirectoryWatcher(dir as FilePath)
     await waitForReady(w)
+    const addEvent = waitForEvent(w, (e) => e.kind === 'add' && e.path === target)
     await writeFile(target, 'hello')
-    const ev = await waitForEvent(w, (e) => e.kind === 'add' && e.path === target)
+    const ev = await addEvent
     expect(ev.kind).toBe('add')
     expect(
       await danglingCache.check({
@@ -108,8 +109,9 @@ describe('createDirectoryWatcher', () => {
 
     const w = createDirectoryWatcher(dir as FilePath, { stabilityThresholdMs: 0 })
     await waitForReady(w)
+    const unlinkEvent = waitForEvent(w, (e) => e.kind === 'unlink' && e.path === target)
     await rm(target)
-    const ev = await waitForEvent(w, (e) => e.kind === 'unlink' && e.path === target)
+    const ev = await unlinkEvent
     expect(ev.kind).toBe('unlink')
     expect(
       await danglingCache.check({
@@ -137,12 +139,14 @@ describe('createDirectoryWatcher', () => {
     await waitForReady(w)
 
     // First write registers the file (fires 'add'); second write fires 'change'.
+    const addEvent = waitForEvent(w, (e) => e.kind === 'add' && e.path === target)
     await writeFile(target, 'v1')
-    await waitForEvent(w, (e) => e.kind === 'add' && e.path === target)
+    await addEvent
     // Brief settle so chokidar's awaitWriteFinish window closes on the add.
     await new Promise((r) => setTimeout(r, 250))
+    const changeEvent = waitForEvent(w, (e) => e.kind === 'change' && e.path === target)
     await writeFile(target, 'v2-content-larger')
-    const ev = await waitForEvent(w, (e) => e.kind === 'change' && e.path === target)
+    const ev = await changeEvent
     expect(ev.kind).toBe('change')
     await w.close()
   })
@@ -170,8 +174,9 @@ describe('createDirectoryWatcher', () => {
 
     const rootFile = path.join(dir, 'root.txt') as FilePath
     const nestedFile = path.join(nestedDir, 'nested.txt') as FilePath
+    const rootAddEvent = waitForEvent(w, (e) => e.kind === 'add' && e.path === rootFile)
     await writeFile(rootFile, 'root')
-    await waitForEvent(w, (e) => e.kind === 'add' && e.path === rootFile)
+    await rootAddEvent
 
     await writeFile(nestedFile, 'nested')
     await new Promise((r) => setTimeout(r, 400))
@@ -206,8 +211,9 @@ describe('createDirectoryWatcher', () => {
 
       const w = createDirectoryWatcher(dir as FilePath)
       await waitForReady(w)
+      const addEvent = waitForEvent(w, (e) => e.kind === 'add' && e.path?.endsWith('.txt'), 30_000)
       await writeFile(writtenPath, 'hello')
-      const ev = await waitForEvent(w, (e) => e.kind === 'add' && e.path?.endsWith('.txt'), 30_000)
+      const ev = await addEvent
       if (ev.kind !== 'add') throw new Error('expected add event')
       expect(ev.path).toBe(writtenPath)
 

src/renderer/components/ArtifactPreview/office/OfficePreviewPanel.tsx

@@ -7,8 +7,6 @@ import { useTranslation } from 'react-i18next'
 
 const logger = loggerService.withContext('OfficePreviewPanel')
 
-const SUPPORTED_OFFICE_PREVIEW_EXTENSIONS = new Set(['docx', 'pptx'])
-
 interface OfficeDocumentPreviewProps {
   filePath: string
   fileName: string
@@ -31,6 +29,7 @@ export interface OfficePreviewPanelProps {
 
 let wordPreviewPanelPromise: Promise<OfficeDocumentPreviewPanel> | null = null
 let pptxPreviewPanelPromise: Promise<OfficeDocumentPreviewPanel> | null = null
+let xlsxPreviewPanelPromise: Promise<OfficeDocumentPreviewPanel> | null = null
 
 function loadWordPreviewPanel() {
   wordPreviewPanelPromise ??= import('./WordPreviewPanel')
@@ -52,6 +51,26 @@ function loadPptxPreviewPanel() {
   return pptxPreviewPanelPromise
 }
 
+function loadXlsxPreviewPanel() {
+  xlsxPreviewPanelPromise ??= import('./XlsxPreviewPanel')
+    .then((module) => module.XlsxPreviewPanel)
+    .catch((err: unknown) => {
+      xlsxPreviewPanelPromise = null
+      throw err
+    })
+  return xlsxPreviewPanelPromise
+}
+
+// Extension → lazy panel loader. Doubles as the source of truth for which office
+// documents get an inline preview; anything not listed falls back to "open externally".
+const OFFICE_PREVIEW_LOADERS: Record<string, () => Promise<OfficeDocumentPreviewPanel>> = {
+  docx: loadWordPreviewPanel,
+  pptx: loadPptxPreviewPanel,
+  xlsx: loadXlsxPreviewPanel
+}
+
+const SUPPORTED_OFFICE_PREVIEW_EXTENSIONS = new Set(Object.keys(OFFICE_PREVIEW_LOADERS))
+
 function extOf(name: string | undefined): string {
   if (!name) return ''
   const dot = name.lastIndexOf('.')
@@ -115,7 +134,8 @@ function SupportedOfficePreview({
     let cancelled = false
     setLoadError(null)
 
-    const loader = extension === 'docx' ? loadWordPreviewPanel : loadPptxPreviewPanel
+    const loader = OFFICE_PREVIEW_LOADERS[extension]
+    if (!loader) return
     loader()
       .then((Component) => {
         if (!cancelled) setLoadedPreview({ extension, Component })

src/renderer/components/ArtifactPreview/office/WordPreviewPanel.tsx

@@ -7,7 +7,7 @@ import { useTranslation } from 'react-i18next'
 
 import DocumentPreviewToolbar from '../DocumentPreviewToolbar'
 import { toUint8Array } from '../toUint8Array'
-import { assertDocxZipLimits } from './docxZipPreflight'
+import { assertZipLimits } from './zipPreflight'
 
 const logger = loggerService.withContext('WordPreviewPanel')
 
@@ -144,7 +144,7 @@ const WordPreviewPanel = ({ filePath, fileName, refreshKey, sourceSize, actions
         assertSourceSize(docxData.byteLength)
         if (!isCurrent()) return
 
-        assertDocxZipLimits(docxData)
+        assertZipLimits(docxData, 'DOCX')
         if (!isCurrent()) return
 
         await renderAsync(docxData, stagingBody, stagingStyle, {