documentation-hub 5.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/.eslintrc.json +43 -0
  2. package/.github/workflows/build.yml +64 -0
  3. package/.github/workflows/ci.yml +39 -0
  4. package/.vscode/extensions.json +3 -0
  5. package/Current.md +97 -0
  6. package/DocHub_Image.png +0 -0
  7. package/README.md +666 -0
  8. package/USER_GUIDE.md +1173 -0
  9. package/Updater.md +311 -0
  10. package/build/256x256.png +0 -0
  11. package/build/512x512.png +0 -0
  12. package/build/app-update.yml +4 -0
  13. package/build/create-icon.js +208 -0
  14. package/build/icon.ico +0 -0
  15. package/build/icon.png +0 -0
  16. package/build/icon_1024x1024.png +0 -0
  17. package/dist/assets/Analytics-BpsG9895.js +1 -0
  18. package/dist/assets/Card-IAZin8kp.js +1 -0
  19. package/dist/assets/CurrentSession-B-rFkHvf.js +12 -0
  20. package/dist/assets/Dashboard-C_5gMb0q.js +1 -0
  21. package/dist/assets/Documents-CqZ25axS.js +1 -0
  22. package/dist/assets/Input-l89xwXBi.js +1 -0
  23. package/dist/assets/Reporting-DqdHJY_a.js +1 -0
  24. package/dist/assets/Search-XNbu5z_3.js +1 -0
  25. package/dist/assets/SessionManager-lH9hZfzH.js +1 -0
  26. package/dist/assets/Sessions-ClZOPYNc.js +1 -0
  27. package/dist/assets/Settings-DUEHGURa.js +11 -0
  28. package/dist/assets/index-8xUe8ptc.js +24 -0
  29. package/dist/assets/index-RYyJqF7O.css +1 -0
  30. package/dist/assets/path-BkOl0AGO.js +1 -0
  31. package/dist/assets/promises-ID_B9S-h.js +1 -0
  32. package/dist/assets/urlHelpers-TvgahX0r.js +1 -0
  33. package/dist/assets/useToast-yRSO1dkm.js +1 -0
  34. package/dist/assets/vendor-charts-RkGK5ROP.js +36 -0
  35. package/dist/assets/vendor-db-l0sNRNKZ.js +1 -0
  36. package/dist/assets/vendor-react-BVZ_anCF.js +4 -0
  37. package/dist/assets/vendor-search-Dw8P0qyA.js +1 -0
  38. package/dist/assets/vendor-ui-BU7NfluV.js +53 -0
  39. package/dist/electron/PowerAutomateApiService-LfW09ZGr.js +147 -0
  40. package/dist/electron/main-CXkNtyv-.js +19789 -0
  41. package/dist/electron/main.js +5 -0
  42. package/dist/electron/preload.js +1 -0
  43. package/dist/icon.png +0 -0
  44. package/dist/index.html +27 -0
  45. package/docs/CODEBASE_ANALYSIS_REPORT.md +309 -0
  46. package/docs/DEBUG_LOGGING_GUIDE.md +244 -0
  47. package/docs/README.md +115 -0
  48. package/docs/TOC_WIRING_GUIDE.md +344 -0
  49. package/docs/analysis/Bullet_Symbol_Bug_Analysis.md +136 -0
  50. package/docs/analysis/DOCXMLATER_ANALYSIS_SUMMARY.txt +169 -0
  51. package/docs/analysis/Document_Processing_Issues_Analysis.md +704 -0
  52. package/docs/analysis/FIELD_PRESERVATION_ANALYSIS.md +1200 -0
  53. package/docs/analysis/INDENTATION_PRESERVE_ANALYSIS.md +181 -0
  54. package/docs/analysis/INDENTATION_PRESERVE_IMPLEMENTATION.md +207 -0
  55. package/docs/analysis/List_Implementation.md +206 -0
  56. package/docs/analysis/List_Implementation_Accuracy_Report.md +366 -0
  57. package/docs/analysis/PROCESSING_OPTIONS_UI_UPDATES.md +220 -0
  58. package/docs/analysis/RefactorStyles.md +852 -0
  59. package/docs/analysis/STYLE_PARAMETER_ENHANCEMENT.md +143 -0
  60. package/docs/analysis/docxmlater-comparison-todo-2025-11-13.md +636 -0
  61. package/docs/analysis/docxmlater-implementation-analysis-2025-11-13.md +340 -0
  62. package/docs/analysis/docxmlater-template_ui-integration-analysis.md +263 -0
  63. package/docs/analysis/github-issues-to-create.md +237 -0
  64. package/docs/api/API_README.md +538 -0
  65. package/docs/api/API_REFERENCE.md +751 -0
  66. package/docs/api/TYPE_DEFINITIONS.md +869 -0
  67. package/docs/architecture/FONT_EMBEDDING_GUIDE.md +318 -0
  68. package/docs/architecture/docxmlater-functions-and-structure.md +726 -0
  69. package/docs/docxmlater-readme.md +1341 -0
  70. package/docs/fixes/EXECUTION_LOG_TEST_BASE.md +573 -0
  71. package/docs/fixes/HYPERLINK_TEXT_SANITIZATION.md +253 -0
  72. package/docs/fixes/README.md +37 -0
  73. package/docs/github-issues/issue-1-body.md +125 -0
  74. package/docs/github-issues/issue-10-body.md +850 -0
  75. package/docs/github-issues/issue-2-body.md +200 -0
  76. package/docs/github-issues/issue-3-body.md +270 -0
  77. package/docs/github-issues/issue-4-body.md +169 -0
  78. package/docs/github-issues/issue-5-body.md +173 -0
  79. package/docs/github-issues/issue-6-body.md +158 -0
  80. package/docs/github-issues/issue-7-body.md +171 -0
  81. package/docs/github-issues/issue-8-body.md +407 -0
  82. package/docs/github-issues/issue-9-body.md +515 -0
  83. package/docs/github-issues/issue-tracker.md +274 -0
  84. package/docs/github-issues/predictive-analysis-2025-10-18.md +2131 -0
  85. package/docs/implementation/List_Framework_Refactor_Plan.md +336 -0
  86. package/docs/implementation/PRIMARY_TEXT_COLOR_FEATURE.md +217 -0
  87. package/docs/implementation/RELEASE_PLAN_v2.1.0.md +362 -0
  88. package/docs/implementation/RefactorStyles.md +588 -0
  89. package/docs/implementation/implement-plan.md +489 -0
  90. package/docs/implementation/missing-helpers-implementation.md +391 -0
  91. package/docs/implementation/refactor-plan.md +520 -0
  92. package/docs/implementation/session-implementation-complete.md +233 -0
  93. package/docs/implementation/session-management-plan.md +250 -0
  94. package/docs/setup-checklist.md +77 -0
  95. package/docs/versions/changelog.md +345 -0
  96. package/electron/customUpdater.ts +656 -0
  97. package/electron/main.ts +2441 -0
  98. package/electron/memoryConfig.ts +187 -0
  99. package/electron/preload.ts +394 -0
  100. package/electron/proxyConfig.ts +340 -0
  101. package/electron/services/BackupService.ts +452 -0
  102. package/electron/services/DictionaryService.ts +402 -0
  103. package/electron/services/LocalDictionaryLookupService.ts +147 -0
  104. package/electron/services/PowerAutomateApiService.ts +231 -0
  105. package/electron/services/SharePointSyncService.ts +474 -0
  106. package/electron/windowsCertStore.ts +427 -0
  107. package/electron/zscalerConfig.ts +381 -0
  108. package/eslint.config.js +92 -0
  109. package/jest.config.js +52 -0
  110. package/package.json +214 -0
  111. package/postcss.config.mjs +6 -0
  112. package/public/icon.png +0 -0
  113. package/publish-release.ps1 +5 -0
  114. package/renovate.json +30 -0
  115. package/src/App.tsx +216 -0
  116. package/src/__mocks__/p-limit.js +12 -0
  117. package/src/__mocks__/styleMock.js +1 -0
  118. package/src/components/common/BugReportButton.tsx +44 -0
  119. package/src/components/common/BugReportDialog.tsx +193 -0
  120. package/src/components/common/Button.tsx +153 -0
  121. package/src/components/common/Card.tsx +86 -0
  122. package/src/components/common/ColorPickerDialog.tsx +177 -0
  123. package/src/components/common/ConfirmDialog.tsx +96 -0
  124. package/src/components/common/DebugConsole.tsx +275 -0
  125. package/src/components/common/EmptyState.tsx +183 -0
  126. package/src/components/common/ErrorBoundary.tsx +98 -0
  127. package/src/components/common/ErrorDetailsDialog.tsx +153 -0
  128. package/src/components/common/ErrorFallback.tsx +218 -0
  129. package/src/components/common/Input.tsx +109 -0
  130. package/src/components/common/Skeleton.tsx +184 -0
  131. package/src/components/common/SplashScreen.tsx +81 -0
  132. package/src/components/common/Toast.tsx +155 -0
  133. package/src/components/common/Tooltip.tsx +79 -0
  134. package/src/components/common/UpdateNotification.tsx +320 -0
  135. package/src/components/comparison/ComparisonWindow.tsx +374 -0
  136. package/src/components/comparison/SideBySideDiff.tsx +486 -0
  137. package/src/components/comparison/index.ts +8 -0
  138. package/src/components/document/DocumentUploader.tsx +288 -0
  139. package/src/components/document/HyperlinkPreview.tsx +430 -0
  140. package/src/components/document/HyperlinkService.md +1484 -0
  141. package/src/components/document/Hyperlink_Technical_Documentation.md +496 -0
  142. package/src/components/document/InlineChangesView.tsx +707 -0
  143. package/src/components/document/ProcessingProgress.tsx +303 -0
  144. package/src/components/document/ProcessingResults.tsx +256 -0
  145. package/src/components/document/TrackedChangesDetail.tsx +530 -0
  146. package/src/components/document/TrackedChangesPanel.tsx +546 -0
  147. package/src/components/document/VirtualDocumentList.tsx +240 -0
  148. package/src/components/editor/DocumentEditor.tsx +723 -0
  149. package/src/components/editor/DocumentEditorModal.tsx +640 -0
  150. package/src/components/editor/EditorQuickActions.tsx +502 -0
  151. package/src/components/editor/EditorToolbar.tsx +312 -0
  152. package/src/components/editor/TableEditor.tsx +926 -0
  153. package/src/components/editor/index.ts +18 -0
  154. package/src/components/layout/Header.tsx +190 -0
  155. package/src/components/layout/Sidebar.tsx +313 -0
  156. package/src/components/layout/TitleBar.tsx +190 -0
  157. package/src/components/navigation/CommandPalette.tsx +233 -0
  158. package/src/components/navigation/KeyboardShortcutsModal.tsx +173 -0
  159. package/src/components/sessions/ChangeItem.tsx +408 -0
  160. package/src/components/sessions/ChangeViewer.tsx +1155 -0
  161. package/src/components/sessions/DocumentComparisonModal.tsx +314 -0
  162. package/src/components/sessions/ProcessingOptions.tsx +297 -0
  163. package/src/components/sessions/ReplacementsTab.tsx +438 -0
  164. package/src/components/sessions/RevisionHandlingOptions.tsx +87 -0
  165. package/src/components/sessions/SessionManager.tsx +188 -0
  166. package/src/components/sessions/StylesEditor.tsx +1335 -0
  167. package/src/components/sessions/TabContainer.tsx +151 -0
  168. package/src/components/sessions/VirtualSessionList.tsx +157 -0
  169. package/src/components/sessions/sessionToProcessorManager.tsx +420 -0
  170. package/src/components/settings/CertificateManager.tsx +410 -0
  171. package/src/components/settings/SegmentedControl.tsx +88 -0
  172. package/src/components/settings/SettingRow.tsx +52 -0
  173. package/src/contexts/GlobalStatsContext.tsx +396 -0
  174. package/src/contexts/SessionContext.tsx +2129 -0
  175. package/src/contexts/ThemeContext.tsx +428 -0
  176. package/src/contexts/UserSettingsContext.tsx +290 -0
  177. package/src/contexts/__tests__/GlobalStatsContext.test.tsx +390 -0
  178. package/src/global.d.ts +273 -0
  179. package/src/hooks/useDocumentQueue.tsx +210 -0
  180. package/src/hooks/useToast.tsx +55 -0
  181. package/src/main.tsx +10 -0
  182. package/src/pages/Analytics.tsx +386 -0
  183. package/src/pages/CurrentSession.tsx +1174 -0
  184. package/src/pages/Dashboard.tsx +319 -0
  185. package/src/pages/Documents.tsx +317 -0
  186. package/src/pages/Projects.tsx +250 -0
  187. package/src/pages/Reporting.tsx +386 -0
  188. package/src/pages/Search.tsx +349 -0
  189. package/src/pages/Sessions.tsx +285 -0
  190. package/src/pages/Settings.tsx +2662 -0
  191. package/src/services/HyperlinkService.ts +1085 -0
  192. package/src/services/document/DocXMLaterProcessor.ts +617 -0
  193. package/src/services/document/DocumentProcessingComparison.ts +856 -0
  194. package/src/services/document/DocumentSnapshotService.ts +575 -0
  195. package/src/services/document/WordDocumentProcessor.ts +10509 -0
  196. package/src/services/document/__tests__/DocXMLaterProcessor.hyperlinks.test.md +311 -0
  197. package/src/services/document/__tests__/WordDocumentProcessor.integration.test.ts +515 -0
  198. package/src/services/document/__tests__/WordDocumentProcessor.test.ts +812 -0
  199. package/src/services/document/blanklines/BlankLineManager.ts +658 -0
  200. package/src/services/document/blanklines/__tests__/paragraphChecks.test.ts +281 -0
  201. package/src/services/document/blanklines/helpers/blankLineInsertion.ts +87 -0
  202. package/src/services/document/blanklines/helpers/blankLineSnapshot.ts +251 -0
  203. package/src/services/document/blanklines/helpers/clearCustom.ts +121 -0
  204. package/src/services/document/blanklines/helpers/contextChecks.ts +117 -0
  205. package/src/services/document/blanklines/helpers/imageChecks.ts +51 -0
  206. package/src/services/document/blanklines/helpers/paragraphChecks.ts +236 -0
  207. package/src/services/document/blanklines/helpers/removeBlanksBetweenListItems.ts +91 -0
  208. package/src/services/document/blanklines/helpers/removeTrailingBlanks.ts +35 -0
  209. package/src/services/document/blanklines/helpers/tableGuards.ts +21 -0
  210. package/src/services/document/blanklines/index.ts +67 -0
  211. package/src/services/document/blanklines/rules/additionRules.ts +337 -0
  212. package/src/services/document/blanklines/rules/indentationRules.ts +317 -0
  213. package/src/services/document/blanklines/rules/removalRules.ts +362 -0
  214. package/src/services/document/blanklines/rules/ruleTypes.ts +92 -0
  215. package/src/services/document/blanklines/types.ts +29 -0
  216. package/src/services/document/helpers/ImageBorderCropper.ts +377 -0
  217. package/src/services/document/helpers/__tests__/whitespace.test.ts +272 -0
  218. package/src/services/document/helpers/whitespace.ts +117 -0
  219. package/src/services/document/list/ListNormalizer.ts +947 -0
  220. package/src/services/document/list/index.ts +45 -0
  221. package/src/services/document/list/list-detection.ts +275 -0
  222. package/src/services/document/list/list-types.ts +162 -0
  223. package/src/services/document/processors/HyperlinkProcessor.ts +370 -0
  224. package/src/services/document/processors/ListProcessor.ts +257 -0
  225. package/src/services/document/processors/StructureProcessor.ts +176 -0
  226. package/src/services/document/processors/StyleProcessor.ts +389 -0
  227. package/src/services/document/processors/TableProcessor.ts +2238 -0
  228. package/src/services/document/processors/__tests__/HyperlinkProcessor.test.ts +314 -0
  229. package/src/services/document/processors/__tests__/ListProcessor.test.ts +291 -0
  230. package/src/services/document/processors/__tests__/StructureProcessor.test.ts +257 -0
  231. package/src/services/document/processors/__tests__/TableProcessor.hlp-tips-bullets.test.ts +459 -0
  232. package/src/services/document/processors/__tests__/TableProcessor.test.ts +1604 -0
  233. package/src/services/document/processors/index.ts +28 -0
  234. package/src/services/document/types/docx-processing.ts +310 -0
  235. package/src/services/editor/EditorActionHandlers.ts +901 -0
  236. package/src/services/editor/index.ts +13 -0
  237. package/src/setupTests.ts +47 -0
  238. package/src/styles/global.css +782 -0
  239. package/src/types/backup.ts +132 -0
  240. package/src/types/dictionary.ts +125 -0
  241. package/src/types/document-processing.ts +331 -0
  242. package/src/types/docxmlater-augments.d.ts +142 -0
  243. package/src/types/editor.ts +280 -0
  244. package/src/types/electron.ts +340 -0
  245. package/src/types/globalStats.ts +155 -0
  246. package/src/types/hyperlink.ts +471 -0
  247. package/src/types/operations.ts +354 -0
  248. package/src/types/session.ts +427 -0
  249. package/src/types/settings.ts +112 -0
  250. package/src/utils/MemoryMonitor.ts +248 -0
  251. package/src/utils/cn.ts +6 -0
  252. package/src/utils/colorConvert.ts +306 -0
  253. package/src/utils/diffUtils.ts +347 -0
  254. package/src/utils/documentUtils.ts +202 -0
  255. package/src/utils/electronGuard.ts +62 -0
  256. package/src/utils/indexedDB.ts +915 -0
  257. package/src/utils/logger.ts +717 -0
  258. package/src/utils/pathSecurity.ts +232 -0
  259. package/src/utils/pathValidator.ts +236 -0
  260. package/src/utils/processingTimeEstimator.ts +153 -0
  261. package/src/utils/safeJsonParse.ts +62 -0
  262. package/src/utils/textSanitizer.ts +162 -0
  263. package/src/utils/urlHelpers.ts +304 -0
  264. package/src/utils/urlPatterns.ts +198 -0
  265. package/src/utils/urlSanitizer.ts +152 -0
  266. package/src/vite-env.d.ts +11 -0
  267. package/tsconfig.electron.json +19 -0
  268. package/tsconfig.json +36 -0
  269. package/tsconfig.node.json +12 -0
  270. package/typedoc.json +45 -0
  271. package/vite.config.ts +152 -0
@@ -0,0 +1,151 @@
1
+ import { useState, useEffect, useRef } from 'react';
2
+ import { motion } from 'framer-motion';
3
+ import { ChevronLeft, ChevronRight } from 'lucide-react';
4
+ import { cn } from '@/utils/cn';
5
+
6
+ interface Tab {
7
+ id: string;
8
+ label: string;
9
+ content: React.ReactNode;
10
+ }
11
+
12
+ interface TabContainerProps {
13
+ tabs: Tab[];
14
+ defaultTab?: string;
15
+ className?: string;
16
+ headerActions?: Record<string, React.ReactNode>; // Action buttons per tab ID
17
+ activeTabId?: string; // Controlled active tab
18
+ onTabChange?: (tabId: string) => void; // Callback when tab changes
19
+ }
20
+
21
+ export function TabContainer({ tabs, defaultTab, className, headerActions, activeTabId, onTabChange }: TabContainerProps) {
22
+ const [internalActiveTab, setInternalActiveTab] = useState(defaultTab || tabs[0]?.id);
23
+
24
+ // Use controlled activeTabId if provided, otherwise use internal state
25
+ const activeTab = activeTabId !== undefined ? activeTabId : internalActiveTab;
26
+
27
+ const handleTabChange = (tabId: string) => {
28
+ if (activeTabId === undefined) {
29
+ setInternalActiveTab(tabId);
30
+ }
31
+ onTabChange?.(tabId);
32
+ };
33
+ const [showLeftArrow, setShowLeftArrow] = useState(false);
34
+ const [showRightArrow, setShowRightArrow] = useState(false);
35
+ const tabsRef = useRef<HTMLDivElement>(null);
36
+ const activeTabData = tabs.find((tab) => tab.id === activeTab);
37
+
38
+ // Check for overflow and update arrow visibility
39
+ useEffect(() => {
40
+ const container = tabsRef.current;
41
+ if (!container) return;
42
+
43
+ const checkScroll = () => {
44
+ const { scrollLeft, scrollWidth, clientWidth } = container;
45
+ setShowLeftArrow(scrollLeft > 0);
46
+ setShowRightArrow(scrollLeft < scrollWidth - clientWidth - 1);
47
+ };
48
+
49
+ checkScroll();
50
+ container.addEventListener('scroll', checkScroll);
51
+ window.addEventListener('resize', checkScroll);
52
+
53
+ return () => {
54
+ container.removeEventListener('scroll', checkScroll);
55
+ window.removeEventListener('resize', checkScroll);
56
+ };
57
+ }, [tabs]);
58
+
59
+ const scrollLeft = () => {
60
+ tabsRef.current?.scrollBy({ left: -200, behavior: 'smooth' });
61
+ };
62
+
63
+ const scrollRight = () => {
64
+ tabsRef.current?.scrollBy({ left: 200, behavior: 'smooth' });
65
+ };
66
+
67
+ return (
68
+ <div className={cn('w-full', className)}>
69
+ {/* Tab Navigation - Sticky */}
70
+ <div className="sticky top-0 bg-background z-20 flex items-center border-b border-border">
71
+ {/* Left Scroll Button */}
72
+ {showLeftArrow && (
73
+ <button
74
+ onClick={scrollLeft}
75
+ className="flex-shrink-0 px-2 py-2.5 text-muted-foreground hover:text-foreground transition-colors"
76
+ aria-label="Scroll tabs left"
77
+ >
78
+ <ChevronLeft className="w-4 h-4" />
79
+ </button>
80
+ )}
81
+
82
+ {/* Scrollable Tabs Container */}
83
+ <div
84
+ ref={tabsRef}
85
+ className="flex gap-1 px-4 overflow-x-auto flex-1"
86
+ style={{
87
+ scrollbarWidth: 'none',
88
+ msOverflowStyle: 'none',
89
+ }}
90
+ >
91
+ {tabs.map((tab) => (
92
+ <button
93
+ key={tab.id}
94
+ onClick={() => handleTabChange(tab.id)}
95
+ className={cn(
96
+ 'relative px-4 py-2.5 text-sm font-medium transition-all whitespace-nowrap',
97
+ 'hover:text-foreground',
98
+ activeTab === tab.id ? 'text-foreground' : 'text-muted-foreground'
99
+ )}
100
+ >
101
+ {tab.label}
102
+ {activeTab === tab.id && (
103
+ <motion.div
104
+ layoutId="activeTab"
105
+ className="absolute bottom-0 left-0 right-0 h-0.5 bg-primary"
106
+ initial={false}
107
+ transition={{
108
+ type: 'spring',
109
+ stiffness: 500,
110
+ damping: 30,
111
+ }}
112
+ />
113
+ )}
114
+ </button>
115
+ ))}
116
+ </div>
117
+
118
+ {/* Right Scroll Button */}
119
+ {showRightArrow && (
120
+ <button
121
+ onClick={scrollRight}
122
+ className="flex-shrink-0 px-2 py-2.5 text-muted-foreground hover:text-foreground transition-colors"
123
+ aria-label="Scroll tabs right"
124
+ >
125
+ <ChevronRight className="w-4 h-4" />
126
+ </button>
127
+ )}
128
+
129
+ {/* Header Actions for Active Tab */}
130
+ {headerActions?.[activeTab] && (
131
+ <div className="flex-shrink-0 px-4 py-2 border-l border-border">
132
+ {headerActions[activeTab]}
133
+ </div>
134
+ )}
135
+ </div>
136
+
137
+ {/* Tab Content */}
138
+ <div className="p-4">
139
+ <motion.div
140
+ key={activeTab}
141
+ initial={{ opacity: 0, y: 10 }}
142
+ animate={{ opacity: 1, y: 0 }}
143
+ exit={{ opacity: 0, y: -10 }}
144
+ transition={{ duration: 0.2 }}
145
+ >
146
+ {activeTabData?.content}
147
+ </motion.div>
148
+ </div>
149
+ </div>
150
+ );
151
+ }
@@ -0,0 +1,157 @@
1
+ import { memo, useCallback, CSSProperties } from 'react';
2
+ // @ts-ignore - react-window exports these despite TypeScript not recognizing them
3
+ import { FixedSizeList as List } from 'react-window';
4
+ import { motion } from 'framer-motion';
5
+ import { FolderOpen, FileText, Clock, CheckCircle, AlertCircle } from 'lucide-react';
6
+ import { Session } from '@/types/session';
7
+ import { cn } from '@/utils/cn';
8
+ import { useNavigate } from 'react-router-dom';
9
+
10
+ interface VirtualSessionListProps {
11
+ sessions: Session[];
12
+ height: number;
13
+ onSessionClick?: (session: Session) => void;
14
+ selectedSessionId?: string;
15
+ }
16
+
17
+ interface SessionRowProps {
18
+ index: number;
19
+ style: CSSProperties;
20
+ data: {
21
+ sessions: Session[];
22
+ onSessionClick?: (session: Session) => void;
23
+ selectedSessionId?: string;
24
+ navigate: ReturnType<typeof useNavigate>;
25
+ };
26
+ }
27
+
28
+ /**
29
+ * Individual session row component
30
+ * Memoized to prevent unnecessary re-renders
31
+ */
32
+ const SessionRow = memo(({ index, style, data }: SessionRowProps) => {
33
+ const session = data.sessions[index];
34
+ const isSelected = session.id === data.selectedSessionId;
35
+
36
+ const handleClick = useCallback(() => {
37
+ if (data.onSessionClick) {
38
+ data.onSessionClick(session);
39
+ }
40
+ data.navigate(`/session/${session.id}`);
41
+ }, [session, data]);
42
+
43
+ const getStatusIcon = () => {
44
+ switch (session.status) {
45
+ case 'active':
46
+ return <FolderOpen className="w-4 h-4 text-primary" />;
47
+ case 'closed':
48
+ return <CheckCircle className="w-4 h-4 text-muted-foreground" />;
49
+ default:
50
+ return <Clock className="w-4 h-4 text-muted-foreground" />;
51
+ }
52
+ };
53
+
54
+ const documentCount = session.documents?.length || 0;
55
+ const processedCount = session.documents?.filter((d) => d.status === 'completed').length || 0;
56
+
57
+ return (
58
+ <div style={style}>
59
+ <motion.div
60
+ whileHover={{ scale: 1.01 }}
61
+ whileTap={{ scale: 0.99 }}
62
+ onClick={handleClick}
63
+ className={cn(
64
+ 'mx-2 p-4 rounded-lg border cursor-pointer transition-all',
65
+ 'hover:shadow-md hover:border-primary/30',
66
+ isSelected && 'border-primary bg-primary/5',
67
+ !isSelected && 'border-border bg-card'
68
+ )}
69
+ >
70
+ <div className="flex items-start justify-between">
71
+ <div className="flex-1">
72
+ <div className="flex items-center gap-2">
73
+ {getStatusIcon()}
74
+ <h3 className="font-semibold text-sm">{session.name}</h3>
75
+ {session.status === 'active' && (
76
+ <span className="px-2 py-0.5 text-xs bg-primary/10 text-primary rounded-full">
77
+ Active
78
+ </span>
79
+ )}
80
+ </div>
81
+
82
+ <div className="mt-2 flex items-center gap-4 text-xs text-muted-foreground">
83
+ <div className="flex items-center gap-1">
84
+ <FileText className="w-3 h-3" />
85
+ <span>{documentCount} documents</span>
86
+ </div>
87
+
88
+ {processedCount > 0 && (
89
+ <div className="flex items-center gap-1">
90
+ <CheckCircle className="w-3 h-3" />
91
+ <span>{processedCount} processed</span>
92
+ </div>
93
+ )}
94
+
95
+ <div className="flex items-center gap-1">
96
+ <Clock className="w-3 h-3" />
97
+ <span>{new Date(session.lastModified).toLocaleDateString()}</span>
98
+ </div>
99
+ </div>
100
+
101
+ {/* Progress bar for processed documents */}
102
+ {documentCount > 0 && (
103
+ <div className="mt-2 w-full bg-muted rounded-full h-1.5">
104
+ <div
105
+ className="bg-primary h-1.5 rounded-full transition-all"
106
+ style={{ width: `${(processedCount / documentCount) * 100}%` }}
107
+ />
108
+ </div>
109
+ )}
110
+ </div>
111
+
112
+ <div className="text-right text-xs text-muted-foreground">
113
+ {session.stats?.timeSaved && (
114
+ <div>{Math.round(session.stats.timeSaved / 60)} min saved</div>
115
+ )}
116
+ </div>
117
+ </div>
118
+ </motion.div>
119
+ </div>
120
+ );
121
+ });
122
+
123
+ SessionRow.displayName = 'SessionRow';
124
+
125
+ /**
126
+ * Virtual scrolling session list component
127
+ * Efficiently renders large lists of sessions
128
+ */
129
+ export const VirtualSessionList = memo(function VirtualSessionList({
130
+ sessions,
131
+ height,
132
+ onSessionClick,
133
+ selectedSessionId,
134
+ }: VirtualSessionListProps) {
135
+ const navigate = useNavigate();
136
+
137
+ // Data passed to each row
138
+ const itemData = {
139
+ sessions,
140
+ onSessionClick,
141
+ selectedSessionId,
142
+ navigate,
143
+ };
144
+
145
+ return (
146
+ <List
147
+ height={height}
148
+ itemCount={sessions.length}
149
+ itemSize={120} // Height of each session row
150
+ width="100%"
151
+ itemData={itemData}
152
+ className="scrollbar-thin scrollbar-thumb-border scrollbar-track-transparent"
153
+ >
154
+ {SessionRow}
155
+ </List>
156
+ );
157
+ });