ts-flp 1.0.2 → 1.0.4

package/dist/src/parser/FlpParser.js

@@ -1,313 +0,0 @@
-/**
- * FL Studio .flp file parser and serializer
- * Conservative patch approach: preserves all unknown data byte-for-byte
- */
-import { DWORD, EVENT_ID, TEXT, WORD, getEventKind } from "../generated/events.generated.js";
-import { BinaryReader } from "../io/BinaryReader.js";
-import { BinaryWriter } from "../io/BinaryWriter.js";
-/**
- * Header structure constants
- */
-const FLP_HEADER_MAGIC = "FLhd";
-const FLP_DATA_MAGIC = "FLdt";
-const FLP_HEADER_SIZE = 6; // Expected header chunk size
-/**
- * Parses an FL Studio project file
- *
- * @param buffer - Raw file data
- * @returns Parsed FLP structure
- * @throws Error if file is corrupted or invalid
- */
-export function parseFlp(buffer) {
-    const reader = new BinaryReader(buffer);
-    // Read FLhd header chunk
-    const headerMagic = reader.readBytes(4).toString("ascii");
-    if (headerMagic !== FLP_HEADER_MAGIC) {
-        throw new Error(`Invalid header magic: expected 'FLhd', got '${headerMagic}'`);
-    }
-    const headerSize = reader.readU32LE();
-    if (headerSize !== FLP_HEADER_SIZE) {
-        throw new Error(`Invalid header size: expected ${FLP_HEADER_SIZE}, got ${headerSize}`);
-    }
-    const format = reader.readI16LE();
-    const channelCount = reader.readU16LE();
-    const ppq = reader.readU16LE();
-    // Validate format (0 = normal project)
-    if (format < -1 || format > 0x50) {
-        throw new Error(`Invalid file format: ${format}`);
-    }
-    // Store complete header chunk (14 bytes)
-    const headerChunkBytes = buffer.subarray(0, 14);
-    // Read FLdt data chunk header
-    const dataMagic = reader.readBytes(4).toString("ascii");
-    if (dataMagic !== FLP_DATA_MAGIC) {
-        throw new Error(`Invalid data magic: expected 'FLdt', got '${dataMagic}'`);
-    }
-    const eventsSize = reader.readU32LE();
-    // Validate events size
-    const expectedFileSize = 22 + eventsSize; // 14 (FLhd) + 8 (FLdt header) + events
-    if (buffer.length !== expectedFileSize) {
-        throw new Error(`Data chunk size mismatch: expected file size ${expectedFileSize}, got ${buffer.length}`);
-    }
-    // Store FLdt header (8 bytes)
-    const fldtHeaderBytes = buffer.subarray(14, 22);
-    // Parse events
-    const events = [];
-    let flVersion = "0.0.0";
-    let useUnicode = false;
-    const eventsStart = reader.tell();
-    const eventsEnd = eventsStart + eventsSize;
-    while (reader.tell() < eventsEnd) {
-        const eventStart = reader.tell();
-        const eventId = reader.readU8();
-        let payloadSize;
-        let headerSize;
-        // Determine payload size based on event ID range
-        if (eventId < WORD) {
-            // BYTE range: 1 byte payload
-            payloadSize = 1;
-            headerSize = 1; // Just the ID
-        }
-        else if (eventId < DWORD) {
-            // WORD range: 2 bytes payload
-            payloadSize = 2;
-            headerSize = 1;
-        }
-        else if (eventId < TEXT) {
-            // DWORD range: 4 bytes payload
-            payloadSize = 4;
-            headerSize = 1;
-        }
-        else {
-            // TEXT/DATA range: VarInt-encoded size
-            const sizeStart = reader.tell();
-            payloadSize = reader.readVarInt();
-            headerSize = 1 + (reader.tell() - sizeStart); // ID + VarInt bytes
-        }
-        // Read payload
-        const payload = reader.readBytes(payloadSize);
-        // Extract header from original buffer for byte-perfect round-trip
-        const header = buffer.subarray(eventStart, eventStart + headerSize);
-        // Determine event kind
-        const kind = getEventKind(eventId);
-        const event = {
-            id: eventId,
-            kind,
-            header: Buffer.from(header),
-            payload: Buffer.from(payload),
-        };
-        events.push(event);
-        // Detect FL version from FLVersion event
-        if (eventId === EVENT_ID.PROJECT_FL_VERSION) {
-            flVersion = payload.toString("ascii").replace(/\0/g, "");
-            const parts = flVersion.split(".").map((p) => parseInt(p, 10));
-            const major = parts[0] ?? 0;
-            const minor = parts[1] ?? 0;
-            useUnicode = parts.length >= 2 && (major > 11 || (major === 11 && minor >= 5));
-        }
-    }
-    // Check for trailing bytes
-    let trailingBytes;
-    if (reader.remaining() > 0) {
-        trailingBytes = reader.readBytes(reader.remaining());
-    }
-    return {
-        headerChunkBytes: Buffer.from(headerChunkBytes),
-        fldtHeaderBytes: Buffer.from(fldtHeaderBytes),
-        events,
-        trailingBytes,
-        flVersion,
-        useUnicode,
-    };
-}
-/**
- * Serializes a parsed FLP back to a buffer
- * Recalculates FLdt chunk size if events have changed
- *
- * @param parsed - Parsed FLP structure
- * @returns Serialized buffer
- */
-export function serializeFlp(parsed) {
-    const writer = new BinaryWriter();
-    // Write FLhd header chunk (preserved byte-for-byte)
-    writer.writeBytes(parsed.headerChunkBytes);
-    // Calculate total events size
-    let eventsSize = 0;
-    for (const event of parsed.events) {
-        eventsSize += serializeEvent(event).length;
-    }
-    // Add trailing bytes if present
-    if (parsed.trailingBytes) {
-        eventsSize += parsed.trailingBytes.length;
-    }
-    // Write FLdt header with updated size
-    writer.writeBytes(Buffer.from(FLP_DATA_MAGIC, "ascii"));
-    writer.writeU32LE(eventsSize);
-    // Write all events
-    for (const event of parsed.events) {
-        writer.writeBytes(serializeEvent(event));
-    }
-    // Write trailing bytes if present
-    if (parsed.trailingBytes) {
-        writer.writeBytes(parsed.trailingBytes);
-    }
-    return writer.toBuffer();
-}
-/**
- * Serializes a single event to bytes
- * Uses original header for unchanged events, recalculates for modified ones
- */
-function serializeEvent(event) {
-    const writer = new BinaryWriter();
-    // Write event ID
-    writer.writeU8(event.id);
-    // For TEXT/DATA events, we need to write the VarInt size
-    if (event.id >= TEXT) {
-        writer.writeVarInt(event.payload.length);
-    }
-    // Write payload
-    writer.writeBytes(event.payload);
-    return writer.toBuffer();
-}
-/**
- * Creates a new event with the given ID and payload
- */
-export function createEvent(id, payload) {
-    const kind = getEventKind(id);
-    // Build header
-    const headerWriter = new BinaryWriter();
-    headerWriter.writeU8(id);
-    if (id >= TEXT) {
-        headerWriter.writeVarInt(payload.length);
-    }
-    return {
-        id,
-        kind,
-        header: headerWriter.toBuffer(),
-        payload: Buffer.from(payload),
-    };
-}
-/**
- * Applies a patcher function to all events
- * Returns a new ParsedFlp with patched events
- *
- * @param parsed - Original parsed FLP
- * @param patcher - Function that transforms each event
- * @returns New ParsedFlp with patched events
- */
-export function patchEvents(parsed, patcher) {
-    const patchedEvents = parsed.events.map((event, index) => {
-        const patched = patcher(event, index);
-        // If payload changed, recalculate header for TEXT/DATA events
-        if (patched.payload !== event.payload && patched.id >= TEXT) {
-            const headerWriter = new BinaryWriter();
-            headerWriter.writeU8(patched.id);
-            headerWriter.writeVarInt(patched.payload.length);
-            return {
-                ...patched,
-                header: headerWriter.toBuffer(),
-            };
-        }
-        return patched;
-    });
-    return {
-        ...parsed,
-        events: patchedEvents,
-    };
-}
-/**
- * Finds all events with a specific ID
- */
-export function findEvents(parsed, eventId) {
-    return parsed.events.filter((e) => e.id === eventId);
-}
-/**
- * Finds the first event with a specific ID
- */
-export function findFirstEvent(parsed, eventId) {
-    return parsed.events.find((e) => e.id === eventId);
-}
-/**
- * Gets event payload as a string (handles encoding)
- */
-export function getEventString(event, useUnicode) {
-    if (event.kind !== "text") {
-        throw new Error(`Event ${event.id} is not a text event`);
-    }
-    if (useUnicode) {
-        const str = event.payload.toString("utf16le");
-        const nullPos = str.indexOf("\0");
-        return nullPos === -1 ? str : str.substring(0, nullPos);
-    }
-    else {
-        const str = event.payload.toString("ascii");
-        const nullPos = str.indexOf("\0");
-        return nullPos === -1 ? str : str.substring(0, nullPos);
-    }
-}
-/**
- * Creates a text payload with proper encoding
- */
-export function createTextPayload(text, useUnicode) {
-    if (useUnicode) {
-        return Buffer.from(text + "\0", "utf16le");
-    }
-    else {
-        return Buffer.from(text + "\0", "ascii");
-    }
-}
-/**
- * Gets event payload as a number
- */
-export function getEventNumber(event) {
-    const reader = new BinaryReader(event.payload);
-    switch (event.kind) {
-        case "u8":
-            return reader.readU8();
-        case "i8":
-            return reader.readI8();
-        case "u16":
-            return reader.readU16LE();
-        case "i16":
-            return reader.readI16LE();
-        case "u32":
-            return reader.readU32LE();
-        case "i32":
-            return reader.readI32LE();
-        case "f32":
-            return reader.readF32LE();
-        default:
-            throw new Error(`Cannot get number from ${event.kind} event`);
-    }
-}
-/**
- * Creates a numeric payload
- */
-export function createNumberPayload(value, kind) {
-    const writer = new BinaryWriter();
-    switch (kind) {
-        case "u8":
-            writer.writeU8(value);
-            break;
-        case "i8":
-            writer.writeI8(value);
-            break;
-        case "u16":
-            writer.writeU16LE(value);
-            break;
-        case "i16":
-            writer.writeI16LE(value);
-            break;
-        case "u32":
-            writer.writeU32LE(value);
-            break;
-        case "i32":
-            writer.writeI32LE(value);
-            break;
-        case "f32":
-            writer.writeF32LE(value);
-            break;
-    }
-    return writer.toBuffer();
-}
-//# sourceMappingURL=FlpParser.js.map

package/dist/src/parser/FlpParser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FlpParser.js","sourceRoot":"","sources":["../../../src/parser/FlpParser.ts"],"names":[],"mappings":"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"}

package/dist/test/flparser.test.js

@@ -1,345 +0,0 @@
-/**
- * FLP Parser unit tests
- * Converted from flparser_unitest.py
- */
-import * as fs from "fs";
-import * as path from "path";
-import { beforeAll, describe, expect, it } from "vitest";
-import { getFlVersion, listPlugins, listSamples, parseFlp, readProjectMeta, readProjectTimeInfo, rewriteSamplePaths, serializeFlp, writeProjectMeta, writeProjectTimeInfo } from "../index.js";
-// Test configuration
-const TEST_PROJS_DIR = path.join(import.meta.dirname, "..", "test_projs");
-const EXPECTED_FL_VERSION = "24"; // Update this to match your FL Studio version
-/**
- * Helper function to get test FLP files
- */
-function getTestableProjects() {
-    if (!fs.existsSync(TEST_PROJS_DIR)) {
-        return [];
-    }
-    return fs.readdirSync(TEST_PROJS_DIR).filter((f) => f.endsWith(".flp"));
-}
-/**
- * Helper function to load and parse a test FLP file
- */
-function loadTestProject(filename) {
-    const filepath = path.join(TEST_PROJS_DIR, filename);
-    const buffer = fs.readFileSync(filepath);
-    return parseFlp(buffer);
-}
-function randomString(length) {
-    let result = "";
-    while (result.length < length) {
-        result += Math.random().toString(36).substring(2);
-    }
-    return result.substring(0, length);
-}
-function randomBPM() {
-    // return a random BPM between 50 and 190
-    return Math.floor(Math.random() * 140) + 50;
-}
-function randomDecimalBPM() {
-    // Random BPM with decimals between 60 and 200
-    return Math.floor(Math.random() * 140000 + 60000) / 1000;
-}
-function randomTimestamp() {
-    // Random date between 2020 and 2025
-    const start = new Date(2020, 0, 1).getTime();
-    const end = new Date(2025, 11, 31).getTime();
-    return new Date(start + Math.random() * (end - start));
-}
-function randomWorkTime() {
-    // Random work time between 0 and 1000000 seconds (~277 hours)
-    return Math.floor(Math.random() * 1000000);
-}
-function randomEmoji() {
-    const emojis = ["🎵", "🎹", "🎸", "🥁", "🎤", "🔊", "🎧", "🎼", "🤓", "👨‍🍳", "🔥", "💯", "✨", "🚀"];
-    return emojis[Math.floor(Math.random() * emojis.length)];
-}
-describe("FLP Parser", () => {
-    const testProjects = getTestableProjects();
-    beforeAll(() => {
-        if (testProjects.length === 0) {
-            console.warn(`No test projects found in ${TEST_PROJS_DIR}`);
-            console.warn("Create a 'test_projs' folder with .flp files to run tests");
-        }
-    });
-    describe("Basic Parsing", () => {
-        it.skipIf(testProjects.length === 0)("should parse FLP file without errors", () => {
-            const project = loadTestProject(testProjects[0]);
-            expect(project).toBeDefined();
-            expect(project.events).toBeDefined();
-            expect(project.events.length).toBeGreaterThan(0);
-        });
-        it.skipIf(testProjects.length === 0)("should detect FL version", () => {
-            const project = loadTestProject(testProjects[0]);
-            const version = getFlVersion(project);
-            expect(version).toBeDefined();
-            expect(version.length).toBeGreaterThan(0);
-            console.log(`Detected FL version: ${version}`);
-        });
-        it.skipIf(testProjects.length === 0)(`should be FL Studio version ${EXPECTED_FL_VERSION}.x`, () => {
-            const project = loadTestProject(testProjects[0]);
-            const version = getFlVersion(project);
-            expect(version.startsWith(EXPECTED_FL_VERSION)).toBe(true);
-        });
-    });
-    describe("Round-trip Stability", () => {
-        it.skipIf(testProjects.length === 0)("should produce identical output when parsing and re-serializing without changes", () => {
-            const filepath = path.join(TEST_PROJS_DIR, testProjects[0]);
-            const originalBuffer = fs.readFileSync(filepath);
-            const parsed = parseFlp(originalBuffer);
-            const reserialized = serializeFlp(parsed);
-            expect(reserialized.length).toBe(originalBuffer.length);
-            expect(reserialized.equals(originalBuffer)).toBe(true);
-        });
-    });
-    describe("Case 1: Basic metadata (title, artist, description, genre)", () => {
-        it.skipIf(testProjects.length === 0)("should read and write basic metadata", () => {
-            const project = loadTestProject(testProjects[0]);
-            const name = randomString(10);
-            const artist = randomString(10);
-            const description = randomString(100);
-            const genre = randomString(15);
-            const modified = writeProjectMeta(project, {
-                name: name,
-                artist: artist,
-                description: description,
-                genre: genre,
-            });
-            const meta = readProjectMeta(modified);
-            expect(meta.name).toBe(name);
-            expect(meta.artist).toBe(artist);
-            expect(meta.description).toContain(description);
-            expect(meta.genre).toBe(genre);
-        });
-    });
-    describe("Case 2: Metadata with genre and tempo", () => {
-        it.skipIf(testProjects.length === 0)("should read and write metadata with genre and tempo", () => {
-            const project = loadTestProject(testProjects[0]);
-            const name = randomString(10);
-            const artist = randomString(10);
-            const description = randomString(100);
-            const genre = randomString(15);
-            const bpm = randomBPM();
-            const modified = writeProjectMeta(project, {
-                name: name,
-                artist: artist,
-                description: description,
-                genre: genre,
-                bpm: bpm,
-            });
-            const meta = readProjectMeta(modified);
-            expect(meta.name).toBe(name);
-            expect(meta.artist).toBe(artist);
-            expect(meta.description).toContain(description);
-            expect(meta.genre).toBe(genre);
-            expect(meta.bpm).toBe(bpm);
-        });
-    });
-    describe("Case 3: Decimal tempo", () => {
-        it.skipIf(testProjects.length === 0)("should handle decimal tempo values", () => {
-            const project = loadTestProject(testProjects[0]);
-            const name = randomString(10);
-            const bpm = randomBPM();
-            const modified = writeProjectMeta(project, {
-                name: name,
-                bpm: bpm,
-            });
-            const meta = readProjectMeta(modified);
-            // BPM is stored as integer * 1000, so we get 3 decimal places precision
-            expect(meta.bpm).toBeCloseTo(bpm, 3);
-        });
-    });
-    describe("Case 4: Type coercion", () => {
-        it.skipIf(testProjects.length === 0)("should handle numeric values as strings", () => {
-            const project = loadTestProject(testProjects[0]);
-            const bpm = randomBPM();
-            // In TypeScript we enforce types, but we test that numeric strings work
-            const modified = writeProjectMeta(project, {
-                name: String(89465),
-                description: String(10231658784241),
-                bpm: bpm,
-            });
-            const meta = readProjectMeta(modified);
-            expect(meta.name).toBe("89465");
-            expect(meta.description).toBe("10231658784241");
-            expect(meta.bpm).toBeCloseTo(bpm, 3);
-        });
-    });
-    describe("Case 5: Samples", () => {
-        it.skipIf(testProjects.length === 0)("should list samples", () => {
-            const project = loadTestProject(testProjects[0]);
-            const samples = listSamples(project);
-            // Just verify we can list samples without error
-            expect(Array.isArray(samples)).toBe(true);
-            console.log(`Found ${samples.length} samples`);
-            if (samples.length > 0) {
-                expect(samples[0]).toHaveProperty("path");
-                expect(samples[0]).toHaveProperty("eventIndex");
-            }
-        });
-        it.skipIf(testProjects.length === 0)("should rewrite sample paths with random prefix", () => {
-            const project = loadTestProject(testProjects[0]);
-            const originalSamples = listSamples(project);
-            if (originalSamples.length > 0) {
-                const randomPrefix = randomString(8);
-                const modified = rewriteSamplePaths(project, (oldPath) => oldPath.replace("C:\\", `${randomPrefix}:\\`));
-                const newSamples = listSamples(modified);
-                expect(newSamples.length).toBe(originalSamples.length);
-                // Verify at least one path was modified
-                const modifiedPaths = newSamples.filter((s) => s.path.includes(randomPrefix));
-                if (originalSamples.some((s) => s.path.includes("C:\\"))) {
-                    expect(modifiedPaths.length).toBeGreaterThan(0);
-                }
-            }
-        });
-    });
-    describe("Case 6: Unicode/Emoji support", () => {
-        it.skipIf(testProjects.length === 0)("should handle emojis in metadata", () => {
-            const project = loadTestProject(testProjects[0]);
-            const emoji1 = randomEmoji();
-            const emoji2 = randomEmoji();
-            const baseName = randomString(10);
-            const artist = randomString(10);
-            const description = randomString(50);
-            const nameWithEmoji = `${baseName} ${emoji1}${emoji2}`;
-            const descWithEmoji = `${description} ${emoji1}`;
-            const modified = writeProjectMeta(project, {
-                name: nameWithEmoji,
-                artist: artist,
-                description: descWithEmoji,
-            });
-            const meta = readProjectMeta(modified);
-            expect(meta.name).toBe(nameWithEmoji);
-            expect(meta.artist).toBe(artist);
-            expect(meta.description).toBe(descWithEmoji);
-        });
-    });
-    describe("Case 7: createdAt timestamp", () => {
-        it.skipIf(testProjects.length === 0)("should read and write creation date", () => {
-            const project = loadTestProject(testProjects[0]);
-            const testDate = randomTimestamp();
-            const modified = writeProjectTimeInfo(project, {
-                creationDate: testDate,
-            });
-            const timeInfo = readProjectTimeInfo(modified);
-            expect(timeInfo.creationDate).toBeDefined();
-            if (timeInfo.creationDate) {
-                // Allow 1 second tolerance due to float precision
-                const diff = Math.abs(timeInfo.creationDate.getTime() - testDate.getTime());
-                expect(diff).toBeLessThan(1000);
-            }
-        });
-    });
-    describe("Case 8: workTime = 0", () => {
-        it.skipIf(testProjects.length === 0)("should handle zero work time", () => {
-            const project = loadTestProject(testProjects[0]);
-            const modified = writeProjectTimeInfo(project, {
-                workTimeSeconds: 0,
-            });
-            const timeInfo = readProjectTimeInfo(modified);
-            expect(timeInfo.workTimeSeconds).toBe(0);
-        });
-    });
-    describe("Case 9: workTime with value", () => {
-        it.skipIf(testProjects.length === 0)("should read and write work time", () => {
-            const project = loadTestProject(testProjects[0]);
-            const workTime = randomWorkTime();
-            const modified = writeProjectTimeInfo(project, {
-                workTimeSeconds: workTime,
-            });
-            const timeInfo = readProjectTimeInfo(modified);
-            expect(timeInfo.workTimeSeconds).toBeCloseTo(workTime, 1);
-        });
-    });
-    describe("Plugins", () => {
-        it.skipIf(testProjects.length === 0)("should list plugins", () => {
-            const project = loadTestProject(testProjects[0]);
-            const plugins = listPlugins(project);
-            expect(Array.isArray(plugins)).toBe(true);
-            console.log(`Found ${plugins.length} plugins`);
-            for (const plugin of plugins) {
-                console.log(`  - ${plugin.name} (${plugin.vendor ?? "N/A"})`);
-            }
-        });
-    });
-    describe("Combined metadata and time info", () => {
-        it.skipIf(testProjects.length === 0)("should handle all modifications together", () => {
-            const project = loadTestProject(testProjects[0]);
-            // Generate random test data
-            const emoji = randomEmoji();
-            const name = `${randomString(10)} ${emoji}`;
-            const artist = randomString(10);
-            const description = randomString(100);
-            const genre = randomString(15);
-            const bpm = randomDecimalBPM();
-            const testDate = randomTimestamp();
-            const workTime = randomWorkTime();
-            // Apply metadata changes
-            let modified = writeProjectMeta(project, {
-                name: name,
-                artist: artist,
-                description: description,
-                genre: genre,
-                bpm: bpm,
-            });
-            // Apply time info changes
-            modified = writeProjectTimeInfo(modified, {
-                creationDate: testDate,
-                workTimeSeconds: workTime,
-            });
-            // Verify all changes
-            const meta = readProjectMeta(modified);
-            expect(meta.name).toBe(name);
-            expect(meta.artist).toBe(artist);
-            expect(meta.description).toBe(description);
-            expect(meta.genre).toBe(genre);
-            expect(meta.bpm).toBeCloseTo(bpm, 3);
-            const timeInfo = readProjectTimeInfo(modified);
-            expect(timeInfo.workTimeSeconds).toBeCloseTo(workTime, 1);
-            // Verify round-trip works
-            const serialized = serializeFlp(modified);
-            const reparsed = parseFlp(serialized);
-            const reMeta = readProjectMeta(reparsed);
-            expect(reMeta.name).toBe(name);
-            expect(reMeta.artist).toBe(artist);
-            expect(reMeta.genre).toBe(genre);
-            expect(reMeta.bpm).toBeCloseTo(bpm, 3);
-            // Save the modified FLP to demo folder
-            const demoDir = path.join(TEST_PROJS_DIR, "demo");
-            if (!fs.existsSync(demoDir)) {
-                fs.mkdirSync(demoDir, { recursive: true });
-            }
-            const outputPath = path.join(demoDir, `modified_${testProjects[0]}`);
-            fs.writeFileSync(outputPath, serialized);
-            console.log(`Saved modified FLP to: ${outputPath}`);
-        });
-    });
-});
-// Run all tests on each available test project
-describe.skipIf(getTestableProjects().length === 0)("All test projects", () => {
-    const projects = getTestableProjects();
-    for (const projectFile of projects) {
-        describe(`Project: ${projectFile}`, () => {
-            it("should parse without errors", () => {
-                const project = loadTestProject(projectFile);
-                expect(project).toBeDefined();
-                expect(project.events.length).toBeGreaterThan(0);
-            });
-            it("should round-trip without data loss", () => {
-                const filepath = path.join(TEST_PROJS_DIR, projectFile);
-                const original = fs.readFileSync(filepath);
-                const parsed = parseFlp(original);
-                const reserialized = serializeFlp(parsed);
-                expect(reserialized.equals(original)).toBe(true);
-            });
-            it("should read metadata", () => {
-                const project = loadTestProject(projectFile);
-                const meta = readProjectMeta(project);
-                expect(meta).toBeDefined();
-                console.log(`  ${projectFile}: "${meta.name}" @ ${meta.bpm} BPM`);
-            });
-        });
-    }
-});
-//# sourceMappingURL=flparser.test.js.map