@lifaon/path/.private/segments/functions/mutate/push-segment-into-mutable-path-segments.js

Useful tool to manage paths like the URL object

import { isRootPathSegment } from '../../segment/functions/is/is-root-path-segement.js';
/**
 * Inserts `segment` at the end of the path.
 *  - may insert `..` if the path is not a single root
 *  - cannot insert a root
 *  - the path remains valid
 */
export function pushSegmentIntoMutablePathSegments(segments, segment, { rootRegExp }) {
    if (segment === '.') {
        // nothing to do
        /* segment is not . */
    }
    else if (segment === '..') {
        const lastSegment = segments[segments.length - 1];
        if (lastSegment === '.') {
            // path is ['.']
            segments[0] = segment; // path becomes ['..']
            /* lastSegment is not . */
        }
        else if (lastSegment === '..') {
            // path is ['..', or more '..']
            segments.push(segment); // path becomes [...'..', '..']
            /* lastSegment is not .. */
        }
        else if (isRootPathSegment(lastSegment, rootRegExp)) {
            // path is [root]
            throw new Error("Cannot push '..' into a path with only one segment of type root");
            /* lastSegment is not a root */
        }
        else {
            // path contains at least one entry [start, ...entries?, entry]
            segments.pop(); // path becomes [start, ...entries?]
        }
        /* segment not .. */
    }
    else if (isRootPathSegment(segment, rootRegExp)) {
        throw new Error('Cannot push a root into a path');
        /* segment is not a root */
    }
    else {
        // segment is an entry
        segments.push(segment);
    }
}
//# sourceMappingURL=push-segment-into-mutable-path-segments.js.map