Class PoseParser

js/poseParser.js:6–528

 */

export class PoseParser {
    /**
     * Parse multiple trajectories from input (separated by blank lines)
     * Supports optional trajectory names via # comment lines before each block.
     * Example:
     *   # My Trajectory
     *   [[[1,0,0,0], ...], ...]
     * 
     * @param {string} input - The input string potentially containing multiple trajectories
     * @param {string} format - The input format ('matrix', 'xyz_quat_wxyz', 'xyz_quat_xyzw')
     * @returns {Object} - { success: boolean, trajectories: array, errors: array, totalCount: number }
     */
    static parseMultiple(input, format = 'matrix') {
        const trajectories = [];
        const errors = [];
        let totalCount = 0;
        
        // Split by double newlines or lines that only contain whitespace between arrays
        const blocks = this.splitIntoBlocks(input);
        
        if (blocks.length === 0) {
            return {
                success: false,
                trajectories: [],
                errors: ['No valid input found'],
                totalCount: 0
            };
        }
        
        blocks.forEach((block, index) => {
            // Extract name from # comment if present
            const { name, content } = this.extractNameFromBlock(block, index);
            
            const result = this.parse(content, format);
            if (result.success) {
                trajectories.push({
                    id: index,
                    name: name,
                    poses: result.data,
                    count: result.count,
                    visible: true
                });
                totalCount += result.count;
            } else {
                errors.push(`${name}: ${result.error}`);
            }
        });
        
        return {
            success: trajectories.length > 0,
            trajectories: trajectories,
            errors: errors,
            totalCount: totalCount
        };
    }

    /**
     * Extract trajectory name from a # comment line at the start of a block