This PR implements the missing opendir API methods that were requested in issue #663. All variants of the Node.js opendir method are now available on the fs export:

• fs.opendir(path[, options], callback)
• fs.opendirSync(path[, options])
• fs.promises.opendir(path[, options]) (was already working)

Root Cause

The opendir functionality was already fully implemented in the Volume class, including:

• ✅ opendirBase() - Core implementation
• ✅ opendir() - Callback version
• ✅ opendirSync() - Synchronous version
• ✅ Dir class - Complete fs.Dir implementation
• ✅ Promise support via FsPromises class

However, the callback and synchronous methods were not exposed in the fs export because they were missing from the API binding lists.

Changes Made

Fixed the API exposure by adding the missing methods to the binding lists:

• Added 'opendir' to fsCallbackApiList.ts
• Added 'opendirSync' to fsSynchronousApiList.ts

Added comprehensive tests in src/__tests__/volume/opendir.test.ts to verify:

• All three API variants work correctly
• Options parameter support (encoding, bufferSize, recursive)
• Proper fs.Dir object interface
• Integration with the main fs export

API Compliance

All implementations fully comply with the Node.js fs API specification:

// Callback version
fs.opendir('/path', { encoding: 'utf8' }, (err, dir) => {
  // Handle directory operations
});

// Synchronous version  
const dir = fs.opendirSync('/path', { bufferSize: 32 });

// Promise version
const dir = await fs.promises.opendir('/path');

The returned fs.Dir objects provide all required methods: read(), readSync(), close(), closeSync(), and async iteration support.

Testing

• ✅ All existing tests continue to pass (54 test suites, 1006 tests)
• ✅ Added 5 new tests specifically for opendir functionality
• ✅ Verified API compliance with Node.js specification
• ✅ Tested all option parameters and edge cases

Fixes #663.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.