yargs-file-commands/dist/lib/segmentPath.js

A yargs helper function that lets you define your commands structure via directory and file naming conventions.

/**
 * Converts a file path into an array of command segments
 * @param {string} fullPath - The complete file system path to the command file
 * @param {string} baseDir - The base directory to make the path relative to
 * @returns {string[]} Array of segments representing the command hierarchy
 *
 * @description
 * This function processes a file path into command segments by:
 * 1. Making the path relative to the base directory
 * 2. Splitting on directory separators
 * 3. Removing file extensions
 * 4. Splitting on dots for nested commands
 * 5. Filtering out empty segments and 'command' keyword
 *
 * @example
 * segmentPath('/base/dir/hello/world.command.ts', '/base/dir')
 * // Returns: ['hello', 'world']
 */
// Top-level regex patterns for performance
const LEADING_SLASHES_REGEX = /^[/\\\\]+/;
const PATH_SEPARATOR_REGEX = /[/\\\\]/;
export const segmentPath = (fullPath, baseDir) => {
    // Remove base directory and normalize slashes
    const relativePath = fullPath.replace(baseDir, '').replace(LEADING_SLASHES_REGEX, '');
    // Split into path segments and filename
    const allSegments = relativePath.split(PATH_SEPARATOR_REGEX);
    // Process all segments including filename
    // Split segments containing periods (this will split the extension from the filename)
    const processedSegments = allSegments
        .flatMap((segment) => segment.split('.'))
        // Filter out empty segments and 'command'
        .filter((segment) => segment !== '' && segment !== 'command');
    return processedSegments;
};
//# sourceMappingURL=segmentPath.js.map