@fullstackcraft/codevideo-virtual-file-explorer

codevideo-virtual-file-explorer is a TypeScript class that simulates an IDE file explorer with the ability to create, delete, and modify folder and file structures. This lightweight and versatile library is ideal for building educational tools, code playgrounds, and interactive coding environments within web applications.

This library heavily relies on the types from codevideo-types

Example Usage

import { VirtualFileExplorer } from '@fullstackcraftllc/codevideo-virtual-file-explorer';
import { advancedCommandSeparator } from '@fullstackcraftllc/codevideo-types';

// Initialize a VirtualFileExplorer instance
const virtualFileExplorer = new VirtualFileExplorer();

// Apply file explorer actions
virtualFileExplorer.applyActions([
  // create a test.js file
  { name: 'create-file', value: 'test.js' },
  
  // creates a src folder
  { name: 'create-folder', value: 'src' },
  
  // create an index.js file in the src folder
  { name: 'create-file', value: 'src/index.js' },
  
  // rename test.js to main.js
  { name: 'rename-file', value: `test.js${advancedCommandSeparator}main.js` },
  
  // copy index.js
  { name: 'copy-file', value: `src/index.js${advancedCommandSeparator}src/index.backup.js` },
  
  // move main.js into src
  { name: 'move-file', value: `main.js${advancedCommandSeparator}src/main.js` },
  
  // create components folder
  { name: 'create-folder', value: 'src/components' },
  
  // copy components folder
  { name: 'copy-folder', value: `src/components${advancedCommandSeparator}src/shared` },
  
  // move shared folder to root
  { name: 'move-folder', value: `src/shared${advancedCommandSeparator}shared` },
  
  // toggle src folder collapsed state
  { name: 'toggle-folder', value: 'src' },
  
  // delete backup file
  { name: 'delete-file', value: 'src/index.backup.js' },
  
  // delete shared folder
  { name: 'delete-folder', value: 'shared' },
]);

// Get the current state of the file explorer
const fileStructure = virtualFileExplorer.getCurrentFileStructure();
const fileTree = virtualFileExplorer.getCurrentFileTree();
const actionsApplied = virtualFileExplorer.getActionsApplied();

console.log('Current file tree:');
console.log(fileTree);
console.log('Actions applied:');
console.log(actionsApplied);

Available Actions

• file-explorer-create-file: Create a new file
• file-explorer-open-file: Open a file (UI handler)
• file-explorer-rename-file: Rename a file using format "oldpath_____newpath"
• file-explorer-delete-file: Delete a file
• file-explorer-move-file: Move a file using format "oldpath_____newpath"
• file-explorer-copy-file: Copy a file using format "sourcepath_____destpath"
• file-explorer-create-folder: Create a new folder
• file-explorer-rename-folder: Rename a folder using format "oldpath_____newpath"
• file-explorer-delete-folder: Delete a folder
• file-explorer-toggle-folder: Toggle folder's collapsed state
• file-explorer-move-folder: Move a folder using format "oldpath_____newpath"
• file-explorer-copy-folder: Copy a folder using format "sourcepath_____destpath"

Where "_____" is a separator string used for advanced commands. The separator string can be imported using the advancedCommandSeparator exported from @fullstackcraftllc/codevideo-types.

Available Methods

applyAction(action: FileExplorerAction): void

Apply a single action to the file structure.

applyActions(actions: FileExplorerAction[]): void

Apply a series of actions to the file structure.

getCurrentFileStructure(): IFileStructure

Get the current file structure as an object.

getCurrentFileTree(): string

Get a string representation of the current file tree.

getActionsApplied(): FileExplorerAction[]

Get the list of actions that were applied.

Why?

This library is part of the CodeVideo ecosystem, working alongside other tools to create a declarative way to build, edit, and generate step-by-step educational video software courses.

The VirtualFileExplorer provides a programmatic way to simulate file explorer interactions, making it perfect for:

• Recording and replaying file operations
• Creating educational content
• Testing file-system related UI components
• Simulating IDE-like environments in the browser

See more at codevideo.io