Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900
2026-02-28 14:39:40 -05:00
commit d803bfe2b1
7854 changed files with 3522914 additions and 0 deletions
--- a/crates/rvlite/examples/dashboard/VECTOR_INSPECTOR_IMPLEMENTATION.md
+++ b/crates/rvlite/examples/dashboard/VECTOR_INSPECTOR_IMPLEMENTATION.md
@@ -0,0 +1,166 @@
+# Vector Inspector Feature - Implementation Summary
+
+## Overview
+Successfully implemented a Vector Inspector feature for the RvLite dashboard that allows users to view detailed information about vectors by clicking on vector IDs or the "View Details" button.
+
+## Changes Made to `/workspaces/ruvector/crates/rvlite/examples/dashboard/src/App.tsx`
+
+### 1. Imports Added
+
+**Line 90** - Added `VectorEntry` type:
+```typescript
+import useRvLite, { type SearchResult, type CypherResult, type SparqlResult, type SqlResult, type VectorEntry } from './hooks/useRvLite';
+```
+
+**Line 74** - Added `Eye` icon:
+```typescript
+import {
+  // ... other icons
+  ChevronRight,
+  Eye,  // NEW
+} from 'lucide-react';
+```
+
+### 2. useRvLite Hook Enhancement
+
+**Line ~465** - Added `getVector` function to destructuring:
+```typescript
+const {
+  isReady,
+  isLoading,
+  error: rvliteError,
+  stats,
+  insertVector,
+  insertVectorWithId,
+  searchVectors,
+  searchVectorsWithFilter,
+  getVector,  // NEW
+  deleteVector,
+  // ... rest
+} = useRvLite(128, 'cosine');
+```
+
+### 3. State Management
+
+**Line ~528** - Added modal disclosure:
+```typescript
+const { isOpen: isVectorDetailOpen, onOpen: onVectorDetailOpen, onClose: onVectorDetailClose } = useDisclosure();
+```
+
+**Lines ~539-540** - Added state variables:
+```typescript
+const [selectedVectorId, setSelectedVectorId] = useState<string | null>(null);
+const [selectedVectorData, setSelectedVectorData] = useState<VectorEntry | null>(null);
+```
+
+### 4. Handler Function
+
+**Lines ~612-627** - Added `handleViewVector` function:
+```typescript
+const handleViewVector = useCallback((id: string) => {
+  try {
+    const vectorData = getVector(id);
+    if (vectorData) {
+      setSelectedVectorId(id);
+      setSelectedVectorData(vectorData);
+      onVectorDetailOpen();
+      addLog('info', `Viewing vector: ${id}`);
+    } else {
+      addLog('error', `Vector not found: ${id}`);
+    }
+  } catch (err) {
+    addLog('error', `Failed to get vector: ${getErrorMessage(err)}`);
+  }
+}, [getVector, setSelectedVectorId, setSelectedVectorData, onVectorDetailOpen, addLog]);
+```
+
+### 5. Table Modifications
+
+**Lines ~1378-1386** - Made Vector ID clickable:
+```typescript
+<TableCell>
+  <div
+    className="flex items-center gap-2 cursor-pointer hover:text-primary transition-colors"
+    onClick={() => handleViewVector(vector.id)}
+  >
+    <FileJson className="w-4 h-4 text-primary" />
+    <span className="font-mono text-sm">{vector.id}</span>
+  </div>
+</TableCell>
+```
+
+**Lines ~1399-1408** - Updated View Details button:
+```typescript
+<Tooltip content="View Details">
+  <Button
+    isIconOnly
+    size="sm"
+    variant="light"
+    onPress={() => handleViewVector(vector.id)}
+  >
+    <Eye className="w-4 h-4" />
+  </Button>
+</Tooltip>
+```
+
+### 6. Vector Detail Modal
+
+**Lines ~2904-3040** - Added complete Vector Inspector Modal with:
+
+- **Header**: Shows "Vector Inspector" title with Eye icon and vector ID chip
+- **Vector ID Section**: Displays ID in a copyable Snippet component with Hash icon
+- **Dimensions Section**: Shows vector dimensions with Layers icon
+- **Embedding Values**: Displays vector array values (first 20 if > 20 total) with copy button
+- **Metadata Section**: Shows formatted JSON metadata with copy button
+- **Error State**: Displays message when vector data is not available
+- **Styling**: Dark theme matching existing dashboard (bg-gray-900, border-gray-700, etc.)
+
+## Features Implemented
+
+✅ Click on Vector ID in table to view details
+✅ Click "View Details" button (Eye icon) to open inspector
+✅ Modal displays:
+  - Vector ID (copyable)
+  - Dimensions count
+  - Embedding values (with smart truncation for long arrays)
+  - Metadata as formatted JSON (or "No metadata" message)
+✅ Copy buttons for:
+  - Vector ID
+  - Embedding array
+  - Metadata JSON
+✅ Logging integration (logs when viewing vector, errors)
+✅ Dark theme styling consistent with dashboard
+✅ Responsive modal (3xl size, scrollable)
+
+## How to Use
+
+1. **View via Table**: Click on any vector ID in the Vectors table
+2. **View via Button**: Click the Eye icon button in the Actions column
+3. **In Modal**:
+   - See all vector details
+   - Copy ID, embedding, or metadata using copy buttons
+   - Close with the "Close" button or ESC key
+
+## Code Quality
+
+- TypeScript type safety maintained
+- Uses existing patterns (useCallback, error handling)
+- Follows HeroUI component conventions
+- Matches existing dark theme styling
+- No breaking changes to existing functionality
+- Proper dependency arrays in hooks
+
+## Testing Notes
+
+The implementation is complete and ready for testing. Pre-existing TypeScript errors in the file (related to SQL table browsing features) are unrelated to this Vector Inspector implementation.
+
+## Files Modified
+
+1. `/workspaces/ruvector/crates/rvlite/examples/dashboard/src/App.tsx` - Main implementation
+
+## Dependencies
+
+- Existing HeroUI components (Modal, ModalContent, ModalHeader, ModalBody, Button, Snippet, Chip)
+- Existing Lucide icons (Eye, Hash, Layers, Code, FileJson, Copy, AlertCircle)
+- useRvLite hook with `getVector` function
+- No new dependencies required