nextav/docs/active/fixes-enhancements/LIBRARY_INTELLISENSE_FEATURE.md

IntelliSense Feature for Library Management

Overview

This feature enhances the library management experience by providing an intelligent folder selection interface when adding new libraries. It lists directories under /mnt and allows users to easily navigate and select folders, while preventing the addition of duplicate libraries.

Features Implemented

1. IntelliSense API Endpoint

• Location: /api/libraries/intellisense
• Functionality:
  • Lists directories under a specified base path (default: /mnt)
  • Identifies which directories are already added as libraries
  • Provides structured JSON response with directory information
  • Supports navigation through directory hierarchy
  • Includes file metadata (size, modification date)

2. Enhanced Settings UI

• Browse Button: Added a "Browse" button next to the library path input field
• Modal Interface: Opens a modal dialog for folder selection when "Browse" is clicked
• Navigation: Allows users to navigate through directory structure by clicking on folders
• Visual Indicators: Greys out and disables selection of folders already added as libraries
• Path Display: Shows the current path being explored
• Separate Selection: Each folder item has a dedicated "Select" button to choose it as a library root
• Current Path Selection: Option to select the currently displayed directory as a library

3. Library Conflict Prevention

• Automatically detects if a folder is already added as a library
• Prevents re-adding existing libraries through the UI
• Clearly indicates which folders are already libraries

Technical Implementation

API Endpoint

The IntelliSense API endpoint (/api/libraries/intellisense) accepts the following query parameters:

• basePath: The base directory to explore (default: /mnt)
• subPath: A subdirectory path to explore within the base path

The response includes:

• path: The current directory path being explored
• parentPath: The parent directory path (null if at root)
• items: An array of directory items with:
  • name: Directory name
  • path: Full directory path
  • isDirectory: Boolean indicating if the item is a directory
  • isAlreadyLibrary: Boolean indicating if the directory is already added as a library
  • size: Size of the directory
  • modified: Last modification date

Frontend Integration

The settings page was modified to include:

• State management for IntelliSense items and UI visibility
• Functions to fetch and display directory listings
• Modal dialog for folder selection with navigation capabilities
• Dedicated "Select" buttons for each folder item
• Integration with existing library management functionality

Usage Instructions

1. Navigate to the Settings page
2. In the "Media Libraries" section, click the "Browse" button next to the library path input
3. A modal dialog will appear showing directories under /mnt
4. To navigate into a folder, click on the folder name
5. To select a folder as a library root:
   • Click the "Select" button next to the folder name, OR
   • Click "Select as Library" next to the current path display
6. The selected path will be populated in the library path input field
7. Click "Add" to add the library

Navigation Features

• Folder Navigation: Click on any folder name to navigate into that directory
• Parent Navigation: Use the ".." entry or the "Back to /mnt" button to navigate up
• Current Directory Selection: Use the "Select as Library" button next to the path display to select the currently viewed directory
• Direct Selection: Each folder has a dedicated "Select" button to choose it as a library root without navigating into it

Testing

The feature has been thoroughly tested with:

• Directory listing functionality
• Library conflict detection
• UI interaction and navigation
• Edge cases and error handling
• Navigation through directory hierarchy

All tests pass successfully, confirming that the IntelliSense feature works as expected.