ts-flp 1.0.0

package/README.md

@@ -0,0 +1,226 @@
+# Typescript FLP Library
+
+A minimalist TypeScript library for reading and modifying FL Studio project files (`.flp`).
+
+Designed for **non-destructive** modifications ("conservative patch").
+
+## Features
+
+- **Project metadata**: Read and modify name, description, artist, genre, and BPM
+- **Time information**: Read and modify creation date and work time
+- **Samples**: List sample paths and batch rewrite paths
+- **VST Plugins**: List plugins with name and vendor (when available)
+- **Stable round-trip**: Untargeted data remains byte-for-byte identical
+
+## Installation
+
+```bash
+npm install ts-flp
+# or
+pnpm add ts-flp
+# or
+yarn add ts-flp
+```
+
+## Usage
+
+### Reading a project
+
+```typescript
+import { readFileSync, writeFileSync } from 'fs';
+import { parseFlp, serializeFlp, readProjectMeta, listSamples, listPlugins } from 'ts-flp';
+
+// Load and parse the .flp file
+const buffer = readFileSync('my-project.flp');
+const parsed = parseFlp(buffer);
+
+// Read metadata
+const meta = readProjectMeta(parsed);
+console.log(`Project: ${meta.name}`);
+console.log(`Artist: ${meta.artist}`);
+console.log(`Genre: ${meta.genre}`);
+console.log(`BPM: ${meta.bpm}`);
+
+// List samples
+const samples = listSamples(parsed);
+for (const sample of samples) {
+  console.log(`Sample: ${sample.path}`);
+}
+
+// List plugins
+const plugins = listPlugins(parsed);
+for (const plugin of plugins) {
+  console.log(`Plugin: ${plugin.name} (${plugin.vendor ?? 'N/A'})`);
+}
+```
+
+### Modifying metadata
+
+```typescript
+import { readFileSync, writeFileSync } from 'fs';
+import { parseFlp, serializeFlp, writeProjectMeta } from 'ts-flp';
+
+const buffer = readFileSync('my-project.flp');
+let parsed = parseFlp(buffer);
+
+// Modify metadata
+parsed = writeProjectMeta(parsed, {
+  name: 'New Title',
+  artist: 'My Name',
+  genre: 'Electronic',
+  bpm: 140,
+});
+
+// Save
+writeFileSync('my-project-modified.flp', serializeFlp(parsed));
+```
+
+### Rewriting sample paths
+
+```typescript
+import { readFileSync, writeFileSync } from 'fs';
+import { parseFlp, serializeFlp, rewriteSamplePaths } from 'ts-flp';
+
+const buffer = readFileSync('my-project.flp');
+let parsed = parseFlp(buffer);
+
+// Remap paths (e.g., disk migration)
+parsed = rewriteSamplePaths(parsed, (oldPath) => {
+  return oldPath.replace('D:\\Samples\\', 'E:\\NewSamples\\');
+});
+
+writeFileSync('my-project-migrated.flp', serializeFlp(parsed));
+```
+
+### Modifying time information
+
+```typescript
+import { readFileSync, writeFileSync } from 'fs';
+import { parseFlp, serializeFlp, readProjectTimeInfo, writeProjectTimeInfo } from 'ts-flp';
+
+const buffer = readFileSync('my-project.flp');
+let parsed = parseFlp(buffer);
+
+// Read time info
+const timeInfo = readProjectTimeInfo(parsed);
+console.log(`Created on: ${timeInfo.creationDate}`);
+console.log(`Work time: ${timeInfo.workTimeSeconds} seconds`);
+
+// Modify creation date
+parsed = writeProjectTimeInfo(parsed, {
+  creationDate: new Date('2024-01-01'),
+  workTimeSeconds: 3600, // 1 hour
+});
+
+writeFileSync('my-project-modified.flp', serializeFlp(parsed));
+```
+
+## API
+
+### Main types
+
+```typescript
+interface ProjectMeta {
+  name: string | null;
+  description: string | null;
+  artist: string | null;
+  genre: string | null;
+  bpm: number | null;
+}
+
+interface ProjectTimeInfo {
+  creationDate: Date | null;
+  workTimeSeconds: number | null;
+}
+
+interface SampleRef {
+  eventIndex: number;
+  path: string;
+}
+
+interface PluginRef {
+  name: string | null;
+  vendor: string | null;
+}
+```
+
+### Functions
+
+| Function                             | Description                                        |
+| ------------------------------------ | -------------------------------------------------- |
+| `parseFlp(buffer)`                   | Parse a `.flp` buffer into a `ParsedFlp` structure |
+| `serializeFlp(parsed)`               | Serialize a `ParsedFlp` structure to buffer        |
+| `readProjectMeta(parsed)`            | Read project metadata                              |
+| `writeProjectMeta(parsed, meta)`     | Modify project metadata                            |
+| `readProjectTimeInfo(parsed)`        | Read time information                              |
+| `writeProjectTimeInfo(parsed, info)` | Modify time information                            |
+| `listSamples(parsed)`                | List all samples in the project                    |
+| `rewriteSamplePaths(parsed, mapper)` | Batch rewrite sample paths                         |
+| `listPlugins(parsed)`                | List all plugins (VST and native)                  |
+| `getFlVersion(parsed)`               | Get the FL Studio version string                   |
+| `getPPQ(parsed)`                     | Get the PPQ (Pulses Per Quarter note)              |
+
+## Constraints and limitations
+
+### What this library does
+
+- **Non-destructive** read and write of `.flp` files
+- Byte-for-byte preservation of unmodified data
+- Compatibility with FL Studio 11.5+ (UTF-16LE strings)
+
+### What this library does NOT do
+
+- Full editor for patterns, mixer, playlist, automation
+- Create `.flp` files from scratch
+- Guarantee VST `vendor` availability (returns `null` if not serialized)
+- Support compressed (zipped) `.flp` files
+
+## Architecture
+
+```
+src/
+  generated/
+    events.generated.ts    # Event constants
+  io/
+    BinaryReader.ts        # Binary reading
+    BinaryWriter.ts        # Binary writing
+  parser/
+    FlpParser.ts           # .flp Parser/Serializer
+  api/
+    ProjectApi.ts          # High-level API
+  index.ts                 # Entry point
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Type checking
+pnpm run typecheck
+
+# Tests
+pnpm run test
+
+# Build
+pnpm run build
+```
+
+## Credits
+
+- [PyFLP](https://github.com/demberto/PyFLP) - Reference implementation for FL Studio file format
+- [smart-buffer](https://github.com/JoshGlazebrook/smart-buffer) - Binary read/write
+- [protobufjs](https://github.com/protobufjs/protobuf.js) - VarInt encoding
+
+## License
+
+[GPL-3.0](LICENSE)
+
+---
+
+## Acknowledgements
+
+A huge thank you to **[@demberto](https://github.com/demberto)** ([PyFLP](https://github.com/demberto/PyFLP)), **[@monadgroup](https://github.com/monadgroup)** ([FLParser](https://github.com/monadgroup/FLParser)), and **FLPEdit** for their incredible reverse-engineering work on the FL Studio `.flp` format.
+
+This project would never have been possible without them.

package/dist/src/api/ProjectApi.d.ts

@@ -0,0 +1,83 @@
+/**
+ * High-level API for reading and modifying FL Studio project files
+ * Provides typed access to project metadata, samples, plugins, and time info
+ */
+import { type ParsedFlp } from "../parser/FlpParser.js";
+/**
+ * Project metadata (name, description, artist, genre, BPM)
+ */
+export interface ProjectMeta {
+    name: string | null;
+    description: string | null;
+    artist: string | null;
+    genre: string | null;
+    bpm: number | null;
+}
+/**
+ * Reads project metadata from a parsed FLP
+ */
+export declare function readProjectMeta(parsed: ParsedFlp): ProjectMeta;
+/**
+ * Writes project metadata to a parsed FLP
+ * Only modifies fields that are provided (non-undefined)
+ */
+export declare function writeProjectMeta(parsed: ParsedFlp, meta: Partial<ProjectMeta>): ParsedFlp;
+/**
+ * Project creation date and work time
+ */
+export interface ProjectTimeInfo {
+    creationDate: Date | null;
+    workTimeSeconds: number | null;
+}
+/**
+ * Reads project time info from a parsed FLP
+ * Timestamp event contains: Float64 created_on (days), Float64 time_spent (days)
+ */
+export declare function readProjectTimeInfo(parsed: ParsedFlp): ProjectTimeInfo;
+/**
+ * Writes project time info to a parsed FLP
+ * Only modifies fields that are provided (non-undefined)
+ *
+ * If `creationDate` or `workTimeSeconds` is set to `null`, the final value will be set on `0` (Delphi epoch)
+ */
+export declare function writeProjectTimeInfo(parsed: ParsedFlp, info: Partial<ProjectTimeInfo>): ParsedFlp;
+/**
+ * Reference to a sample in the project
+ */
+export interface SampleRef {
+    /** Index of the event in the events array */
+    eventIndex: number;
+    /** File path of the sample */
+    path: string;
+}
+/**
+ * Lists all samples in the project
+ */
+export declare function listSamples(parsed: ParsedFlp): SampleRef[];
+/**
+ * Rewrites sample paths using a mapper function
+ */
+export declare function rewriteSamplePaths(parsed: ParsedFlp, mapper: (oldPath: string) => string): ParsedFlp;
+/**
+ * Reference to a plugin in the project
+ */
+export interface PluginRef {
+    /** Plugin name (may be null if not available) */
+    name: string | null;
+    /** Plugin vendor/provider (may be null if not stored in file) */
+    vendor: string | null;
+}
+/**
+ * Lists all plugins (VST and native) in the project
+ * Returns plugin name and vendor where available
+ */
+export declare function listPlugins(parsed: ParsedFlp): PluginRef[];
+/**
+ * Gets the FL Studio version string from the project
+ */
+export declare function getFlVersion(parsed: ParsedFlp): string;
+/**
+ * Gets the PPQ (Pulses Per Quarter note) from the header
+ */
+export declare function getPPQ(parsed: ParsedFlp): number;
+//# sourceMappingURL=ProjectApi.d.ts.map

package/dist/src/api/ProjectApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectApi.d.ts","sourceRoot":"","sources":["../../../src/api/ProjectApi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAOL,KAAK,SAAS,EAEf,MAAM,wBAAwB,CAAC;AAMhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAc9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CA4CzF;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAqBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAkBtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAC7B,SAAS,CAkCX;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,CAgB1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAClC,SAAS,CAqBX;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAqED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,CAoE1D;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAKhD"}

package/dist/src/api/ProjectApi.js

@@ -0,0 +1,326 @@
+/**
+ * High-level API for reading and modifying FL Studio project files
+ * Provides typed access to project metadata, samples, plugins, and time info
+ */
+import { EVENT_ID } from "../generated/events.generated.js";
+import { BinaryReader } from "../io/BinaryReader.js";
+import { BinaryWriter } from "../io/BinaryWriter.js";
+import { createNumberPayload, createTextPayload, findFirstEvent, getEventNumber, getEventString, patchEvents, } from "../parser/FlpParser.js";
+/**
+ * Reads project metadata from a parsed FLP
+ */
+export function readProjectMeta(parsed) {
+    const titleEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_TITLE);
+    const commentsEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_COMMENTS);
+    const artistsEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_ARTISTS);
+    const genreEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_GENRE);
+    const tempoEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_TEMPO);
+    return {
+        name: titleEvent ? getEventString(titleEvent, parsed.useUnicode) : null,
+        description: commentsEvent ? getEventString(commentsEvent, parsed.useUnicode) : null,
+        artist: artistsEvent ? getEventString(artistsEvent, parsed.useUnicode) : null,
+        genre: genreEvent ? getEventString(genreEvent, parsed.useUnicode) : null,
+        bpm: tempoEvent ? getEventNumber(tempoEvent) / 1000 : null,
+    };
+}
+/**
+ * Writes project metadata to a parsed FLP
+ * Only modifies fields that are provided (non-undefined)
+ */
+export function writeProjectMeta(parsed, meta) {
+    return patchEvents(parsed, (event) => {
+        // Patch title
+        if (meta.name !== undefined && event.id === EVENT_ID.PROJECT_TITLE) {
+            return {
+                ...event,
+                payload: createTextPayload(meta.name ?? "", parsed.useUnicode),
+            };
+        }
+        // Patch comments/description
+        if (meta.description !== undefined && event.id === EVENT_ID.PROJECT_COMMENTS) {
+            return {
+                ...event,
+                payload: createTextPayload(meta.description ?? "", parsed.useUnicode),
+            };
+        }
+        // Patch artists
+        if (meta.artist !== undefined && event.id === EVENT_ID.PROJECT_ARTISTS) {
+            return {
+                ...event,
+                payload: createTextPayload(meta.artist ?? "", parsed.useUnicode),
+            };
+        }
+        // Patch genre
+        if (meta.genre !== undefined && event.id === EVENT_ID.PROJECT_GENRE) {
+            return {
+                ...event,
+                payload: createTextPayload(meta.genre ?? "", parsed.useUnicode),
+            };
+        }
+        // Patch tempo (stored as BPM * 1000)
+        if (meta.bpm && Math.abs(meta.bpm) > 0 && event.id === EVENT_ID.PROJECT_TEMPO) {
+            return {
+                ...event,
+                payload: createNumberPayload(Math.round(Math.abs(meta.bpm) * 1000), "u32"),
+            };
+        }
+        return event;
+    });
+}
+// Delphi epoch: December 30, 1899
+const DELPHI_EPOCH = new Date(1899, 11, 30);
+/**
+ * Converts Delphi timestamp (days since epoch) to Date
+ */
+function delphiToDate(days) {
+    const ms = days * 24 * 60 * 60 * 1000;
+    return new Date(DELPHI_EPOCH.getTime() + ms);
+}
+/**
+ * Converts Date to Delphi timestamp (days since epoch)
+ */
+function dateToDelphiDays(date) {
+    const ms = date.getTime() - DELPHI_EPOCH.getTime();
+    return ms / (24 * 60 * 60 * 1000);
+}
+/**
+ * Reads project time info from a parsed FLP
+ * Timestamp event contains: Float64 created_on (days), Float64 time_spent (days)
+ */
+export function readProjectTimeInfo(parsed) {
+    const timestampEvent = findFirstEvent(parsed, EVENT_ID.PROJECT_TIMESTAMP);
+    if (!timestampEvent || timestampEvent.payload.length < 16) {
+        return {
+            creationDate: null,
+            workTimeSeconds: null,
+        };
+    }
+    const reader = new BinaryReader(timestampEvent.payload);
+    const createdOnDays = reader.readF64LE();
+    const timeSpentDays = reader.readF64LE();
+    return {
+        creationDate: delphiToDate(createdOnDays),
+        workTimeSeconds: timeSpentDays * 24 * 60 * 60, // Convert days to seconds
+    };
+}
+/**
+ * Writes project time info to a parsed FLP
+ * Only modifies fields that are provided (non-undefined)
+ *
+ * If `creationDate` or `workTimeSeconds` is set to `null`, the final value will be set on `0` (Delphi epoch)
+ */
+export function writeProjectTimeInfo(parsed, info) {
+    // Read current values to preserve unmodified fields
+    const current = readProjectTimeInfo(parsed);
+    return patchEvents(parsed, (event) => {
+        if (event.id !== EVENT_ID.PROJECT_TIMESTAMP) {
+            return event;
+        }
+        const writer = new BinaryWriter();
+        // Write creation date
+        if (info.creationDate !== undefined && info.creationDate !== null) {
+            writer.writeF64LE(dateToDelphiDays(info.creationDate));
+        }
+        else if (current.creationDate !== null) {
+            writer.writeF64LE(dateToDelphiDays(current.creationDate));
+        }
+        else {
+            writer.writeF64LE(0);
+        }
+        // Write work time
+        if (info.workTimeSeconds !== undefined && info.workTimeSeconds !== null) {
+            writer.writeF64LE(info.workTimeSeconds / (24 * 60 * 60)); // Convert seconds to days
+        }
+        else if (current.workTimeSeconds !== null) {
+            writer.writeF64LE(current.workTimeSeconds / (24 * 60 * 60));
+        }
+        else {
+            writer.writeF64LE(0);
+        }
+        return {
+            ...event,
+            payload: writer.toBuffer(),
+        };
+    });
+}
+/**
+ * Lists all samples in the project
+ */
+export function listSamples(parsed) {
+    const samples = [];
+    parsed.events.forEach((event, index) => {
+        if (event.id === EVENT_ID.CHANNEL_SAMPLE_PATH) {
+            const path = getEventString(event, parsed.useUnicode);
+            if (path && path.length > 0) {
+                samples.push({
+                    eventIndex: index,
+                    path,
+                });
+            }
+        }
+    });
+    return samples;
+}
+/**
+ * Rewrites sample paths using a mapper function
+ */
+export function rewriteSamplePaths(parsed, mapper) {
+    return patchEvents(parsed, (event) => {
+        if (event.id !== EVENT_ID.CHANNEL_SAMPLE_PATH) {
+            return event;
+        }
+        const oldPath = getEventString(event, parsed.useUnicode);
+        if (!oldPath || oldPath.length === 0) {
+            return event;
+        }
+        const newPath = mapper(oldPath);
+        if (newPath === oldPath) {
+            return event;
+        }
+        return {
+            ...event,
+            payload: createTextPayload(newPath, parsed.useUnicode),
+        };
+    });
+}
+/**
+ * VST Plugin Event internal IDs (from plugin.py VSTPluginEvent)
+ */
+const VST_EVENT_ID = {
+    MIDI: 1,
+    FLAGS: 2,
+    IO: 30,
+    INPUTS: 31,
+    OUTPUTS: 32,
+    PLUGIN_INFO: 50,
+    FOUR_CC: 51,
+    GUID: 52,
+    STATE: 53,
+    NAME: 54,
+    PLUGIN_PATH: 55,
+    VENDOR: 56,
+};
+/**
+ * Parses a VST plugin data event to extract name and vendor
+ * Based on VSTPluginEvent structure in PyFLP
+ */
+function parseVstPluginData(payload) {
+    if (payload.length < 4) {
+        return { name: null, vendor: null };
+    }
+    const reader = new BinaryReader(payload);
+    // First 4 bytes: type marker (8, 10, or 11 for VSTs)
+    const typeMarker = reader.readU32LE();
+    // Skip if not a VST plugin marker
+    if (typeMarker !== 8 && typeMarker !== 10 && typeMarker !== 11) {
+        return { name: null, vendor: null };
+    }
+    let name = null;
+    let vendor = null;
+    // Parse sub-events
+    while (reader.remaining() >= 12) {
+        // At minimum: 4 (id) + 8 (size)
+        const subEventId = reader.readU32LE();
+        const dataSize = reader.readU32LE(); // Lower 32 bits of size
+        const dataSizeHigh = reader.readU32LE(); // Upper 32 bits (usually 0)
+        // Combine for 64-bit size (though in practice it's always small)
+        const actualSize = dataSize + dataSizeHigh * 0x100000000;
+        if (actualSize > reader.remaining()) {
+            break;
+        }
+        const data = reader.readBytes(actualSize);
+        // Extract name and vendor
+        if (subEventId === VST_EVENT_ID.NAME && actualSize > 0) {
+            name = data.toString("utf8").replace(/\0/g, "");
+        }
+        else if (subEventId === VST_EVENT_ID.VENDOR && actualSize > 0) {
+            vendor = data.toString("utf8").replace(/\0/g, "");
+        }
+    }
+    return { name, vendor };
+}
+/**
+ * Lists all plugins (VST and native) in the project
+ * Returns plugin name and vendor where available
+ */
+export function listPlugins(parsed) {
+    const plugins = [];
+    const seenPlugins = new Set();
+    // Track current channel context
+    let currentInternalName = null;
+    let currentPluginName = null;
+    for (const event of parsed.events) {
+        // Track channel new events as boundaries
+        if (event.id === EVENT_ID.CHANNEL_NEW) {
+            // Reset context for new channel
+            if (currentInternalName || currentPluginName) {
+                // Save previous channel's plugin if it wasn't a VST (no plugin data)
+                const key = `${currentInternalName ?? ""}:${currentPluginName ?? ""}`;
+                if (!seenPlugins.has(key) && currentInternalName && currentInternalName !== "Fruity Wrapper") {
+                    seenPlugins.add(key);
+                    plugins.push({
+                        name: currentPluginName || currentInternalName,
+                        vendor: null, // Native plugins don't store vendor
+                    });
+                }
+            }
+            currentInternalName = null;
+            currentPluginName = null;
+        }
+        // Track internal name (identifies plugin type)
+        if (event.id === EVENT_ID.PLUGIN_INTERNAL_NAME) {
+            currentInternalName = getEventString(event, parsed.useUnicode);
+        }
+        // Track display name
+        if (event.id === EVENT_ID.PLUGIN_NAME) {
+            currentPluginName = getEventString(event, parsed.useUnicode);
+        }
+        // Parse VST plugin data
+        if (event.id === EVENT_ID.PLUGIN_DATA && currentInternalName === "Fruity Wrapper") {
+            const vstData = parseVstPluginData(event.payload);
+            if (vstData.name) {
+                const key = `vst:${vstData.name}:${vstData.vendor ?? ""}`;
+                if (!seenPlugins.has(key)) {
+                    seenPlugins.add(key);
+                    plugins.push({
+                        name: vstData.name,
+                        vendor: vstData.vendor,
+                    });
+                }
+            }
+            // Reset context after processing VST
+            currentInternalName = null;
+            currentPluginName = null;
+        }
+    }
+    // Handle last channel if any
+    if (currentInternalName && currentInternalName !== "Fruity Wrapper") {
+        const key = `${currentInternalName}:${currentPluginName ?? ""}`;
+        if (!seenPlugins.has(key)) {
+            plugins.push({
+                name: currentPluginName || currentInternalName,
+                vendor: null,
+            });
+        }
+    }
+    return plugins;
+}
+// ============================================================================
+// FL Version
+// ============================================================================
+/**
+ * Gets the FL Studio version string from the project
+ */
+export function getFlVersion(parsed) {
+    return parsed.flVersion;
+}
+/**
+ * Gets the PPQ (Pulses Per Quarter note) from the header
+ */
+export function getPPQ(parsed) {
+    // PPQ is at offset 12-13 in the header (bytes 12-13 of the 14-byte FLhd chunk)
+    const reader = new BinaryReader(parsed.headerChunkBytes);
+    reader.seek(12);
+    return reader.readU16LE();
+}
+//# sourceMappingURL=ProjectApi.js.map

package/dist/src/api/ProjectApi.js.map

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