handoff-app/dist/utils/path.js

Automated documentation toolchain for building client side documentation from figma

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.generateFilesystemSafeId = generateFilesystemSafeId;
/**
 * Generates a filesystem-safe directory name from an absolute path
 * @param workingPath - The absolute working path to transform
 * @returns A filesystem-safe string suitable for use as a directory name
 */
function generateFilesystemSafeId(workingPath) {
    // Normalize path separators to forward slashes for consistent processing
    let safeId = workingPath.replace(/\\/g, '/');
    // Replace forward slashes with dashes
    safeId = safeId.replace(/\//g, '-');
    // Remove or replace invalid filesystem characters
    safeId = safeId.replace(/[<>:"|?*\x00]/g, '-');
    // Remove leading/trailing dashes and spaces
    safeId = safeId.replace(/^[\s-]+|[\s-]+$/g, '');
    // Handle Windows reserved names (case-insensitive)
    const reservedNames = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)/i;
    if (reservedNames.test(safeId)) {
        safeId = `project-${safeId}`;
    }
    // Ensure we have at least one character
    if (!safeId) {
        safeId = 'default-project';
    }
    return safeId;
}