@beatbax/engine 0.1.0

package/dist/import/uge/uge.reader.d.ts

@@ -0,0 +1,27 @@
+export declare function parseUGE(data: Buffer): any;
+export declare function readUGEFile(path: string): any;
+export declare function midiNoteToUGE(midi: number): number;
+export declare function ugeNoteToString(uge: number): string;
+export declare function getUGESummary(song: any): string;
+export declare enum InstrumentType {
+    DUTY = 0,
+    WAVE = 1,
+    NOISE = 2
+}
+export declare enum ChannelType {
+    PULSE1 = 0,
+    PULSE2 = 1,
+    WAVE = 2,
+    NOISE = 3
+}
+export type SubPatternCell = any;
+export type DutyInstrument = any;
+export type WaveInstrument = any;
+export type NoiseInstrument = any;
+export type Instrument = any;
+export type PatternCell = any;
+export type Pattern = any;
+export type UGESong = any;
+declare const _default: {};
+export default _default;
+//# sourceMappingURL=uge.reader.d.ts.map

package/dist/import/uge/uge.reader.d.ts.map

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

package/dist/import/uge/uge.reader.js

@@ -0,0 +1,545 @@
+/**
+ * UGE Reader - Parses hUGETracker .uge files (v5/v6)
+ *
+ * Based on the hUGETracker UGE format specification.
+ * Supports versions 5 and 6 of the UGE format.
+ *
+ * Usage:
+ *   import { readUGEFile, parseUGE } from './uge.reader.js';
+ *   const song = readUGEFile('path/to/song.uge');
+ *   // or
+ *   const buffer = readFileSync('song.uge');
+ *   const song = parseUGE(buffer);
+ */
+import { readFileSync } from 'fs';
+// ============================================================================
+// Type Definitions
+// ============================================================================
+export var InstrumentType;
+(function (InstrumentType) {
+    InstrumentType[InstrumentType["DUTY"] = 0] = "DUTY";
+    InstrumentType[InstrumentType["WAVE"] = 1] = "WAVE";
+    InstrumentType[InstrumentType["NOISE"] = 2] = "NOISE";
+})(InstrumentType || (InstrumentType = {}));
+export var ChannelType;
+(function (ChannelType) {
+    ChannelType[ChannelType["PULSE1"] = 0] = "PULSE1";
+    ChannelType[ChannelType["PULSE2"] = 1] = "PULSE2";
+    ChannelType[ChannelType["WAVE"] = 2] = "WAVE";
+    ChannelType[ChannelType["NOISE"] = 3] = "NOISE";
+})(ChannelType || (ChannelType = {}));
+// ============================================================================
+// Binary Reading Helpers
+// ============================================================================
+class BinaryReader {
+    buffer;
+    offset = 0;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    getOffset() {
+        return this.offset;
+    }
+    readU8(ctx = 'u8') {
+        if (this.offset + 1 > this.buffer.length) {
+            throw new Error(`EOF: Need 1 byte for ${ctx} at offset ${this.offset}`);
+        }
+        const val = this.buffer.readUInt8(this.offset);
+        this.offset += 1;
+        return val;
+    }
+    readU32(ctx = 'u32') {
+        if (this.offset + 4 > this.buffer.length) {
+            throw new Error(`EOF: Need 4 bytes for ${ctx} at offset ${this.offset}`);
+        }
+        const val = this.buffer.readUInt32LE(this.offset);
+        this.offset += 4;
+        return val;
+    }
+    readBool(ctx = 'bool') {
+        return this.readU8(ctx) !== 0;
+    }
+    readShortString(ctx = 'shortstring') {
+        const len = this.readU8(`${ctx}.length`);
+        if (this.offset + 255 > this.buffer.length) {
+            throw new Error(`EOF: Need 255 bytes for ${ctx} at offset ${this.offset}`);
+        }
+        const str = this.buffer.toString('utf8', this.offset, this.offset + len);
+        this.offset += 255; // Always skip 255 bytes regardless of actual length
+        return str;
+    }
+    readString(ctx = 'string') {
+        const len = this.readU32(`${ctx}.length`);
+        if (this.offset + len > this.buffer.length) {
+            throw new Error(`EOF: Need ${len} bytes for ${ctx} at offset ${this.offset}`);
+        }
+        const str = this.buffer.toString('utf8', this.offset, this.offset + len);
+        this.offset += len;
+        // No null terminator in beatbax writer output
+        return str;
+    }
+    skip(bytes) {
+        this.offset += bytes;
+    }
+}
+// ============================================================================
+// Parsing Functions
+// ============================================================================
+function parseSubPatternRows(reader, version, ctx) {
+    const rows = [];
+    for (let r = 0; r < 64; r++) {
+        const note = reader.readU32(`${ctx}.row[${r}].note`);
+        const unused = reader.readU32(`${ctx}.row[${r}].unused`);
+        const jump = reader.readU32(`${ctx}.row[${r}].jump`);
+        const effectCode = reader.readU32(`${ctx}.row[${r}].effectCode`);
+        const effectParam = reader.readU8(`${ctx}.row[${r}].effectParam`);
+        rows.push({ note, jump, effectCode, effectParam });
+    }
+    // v4-v5 have 6 additional unused bytes after rows
+    if (version >= 4 && version < 6) {
+        reader.skip(6);
+    }
+    return rows;
+}
+function parseDutyInstrument(reader, version, idx) {
+    const baseOffset = reader.getOffset();
+    const instType = reader.readU32(`duty[${idx}].type`);
+    if (instType !== 0) {
+        throw new Error(`Expected duty instrument type 0 at offset ${baseOffset}, got ${instType}`);
+    }
+    const name = reader.readShortString(`duty[${idx}].name`);
+    const length = reader.readU32(`duty[${idx}].length`);
+    const lengthEnabled = reader.readBool(`duty[${idx}].lengthEnabled`);
+    const initialVolume = reader.readU8(`duty[${idx}].initialVolume`);
+    const volumeSweepDir = reader.readU32(`duty[${idx}].volumeSweepDir`);
+    const volumeSweepChange = reader.readU8(`duty[${idx}].volumeSweepChange`);
+    const freqSweepTime = reader.readU32(`duty[${idx}].freqSweepTime`);
+    const sweepEnabled = reader.readU32(`duty[${idx}].sweepEnabled`);
+    const freqSweepShift = reader.readU32(`duty[${idx}].freqSweepShift`);
+    const dutyCycle = reader.readU8(`duty[${idx}].dutyCycle`);
+    // Three unused u32s
+    reader.readU32(`duty[${idx}].unused_a`);
+    reader.readU32(`duty[${idx}].unused_b`);
+    reader.readU32(`duty[${idx}].counter_step`);
+    let subpatternEnabled;
+    let rows;
+    if (version < 6) {
+        // v5 has additional unused fields and always includes rows
+        rows = parseSubPatternRows(reader, version, `duty[${idx}]`);
+    }
+    else {
+        // v6: subpattern flag, then 64 rows × 17 bytes (always present in binary)
+        subpatternEnabled = reader.readBool(`duty[${idx}].subpatternEnabled`);
+        // Always skip 64 rows × 17 bytes = 1088 bytes (they're always written)
+        reader.skip(64 * 17);
+    }
+    return {
+        type: InstrumentType.DUTY,
+        name,
+        length,
+        lengthEnabled,
+        initialVolume,
+        volumeSweepDir,
+        volumeSweepChange,
+        freqSweepTime,
+        sweepEnabled,
+        freqSweepShift,
+        dutyCycle,
+        subpatternEnabled,
+        rows
+    };
+}
+function parseWaveInstrument(reader, version, idx) {
+    const baseOffset = reader.getOffset();
+    const instType = reader.readU32(`wave[${idx}].type`);
+    if (instType !== 1) {
+        throw new Error(`Expected wave instrument type 1 at offset ${baseOffset}, got ${instType}`);
+    }
+    const name = reader.readShortString(`wave[${idx}].name`);
+    const length = reader.readU32(`wave[${idx}].length`);
+    const lengthEnabled = reader.readBool(`wave[${idx}].lengthEnabled`);
+    // Skip unused fields
+    reader.readU8(`wave[${idx}].unused1_u8`);
+    reader.readU32(`wave[${idx}].unused2_u32`);
+    reader.readU8(`wave[${idx}].unused3_u8`);
+    reader.readU32(`wave[${idx}].unused4_u32`);
+    reader.readU32(`wave[${idx}].unused5_u32`);
+    reader.readU32(`wave[${idx}].unused6_u32`);
+    reader.readU8(`wave[${idx}].unused7_u8`);
+    const volume = reader.readU32(`wave[${idx}].volume`);
+    const waveIndex = reader.readU32(`wave[${idx}].waveIndex`);
+    reader.readU32(`wave[${idx}].counter_step`);
+    let subpatternEnabled;
+    let rows;
+    if (version < 6) {
+        // v5 has additional unused fields and always includes rows
+        rows = parseSubPatternRows(reader, version, `wave[${idx}]`);
+    }
+    else {
+        // v6: subpattern flag, then 64 rows × 17 bytes (always present in binary)
+        subpatternEnabled = reader.readBool(`wave[${idx}].subpatternEnabled`);
+        // Always skip 64 rows × 17 bytes = 1088 bytes (they're always written)
+        reader.skip(64 * 17);
+    }
+    return {
+        type: InstrumentType.WAVE,
+        name,
+        length,
+        lengthEnabled,
+        volume,
+        waveIndex,
+        subpatternEnabled,
+        rows
+    };
+}
+function parseNoiseInstrument(reader, version, idx) {
+    const baseOffset = reader.getOffset();
+    const instType = reader.readU32(`noise[${idx}].type`);
+    if (instType !== 2) {
+        throw new Error(`Expected noise instrument type 2 at offset ${baseOffset}, got ${instType}`);
+    }
+    const name = reader.readShortString(`noise[${idx}].name`);
+    const length = reader.readU32(`noise[${idx}].length`);
+    const lengthEnabled = reader.readBool(`noise[${idx}].lengthEnabled`);
+    const initialVolume = reader.readU8(`noise[${idx}].initialVolume`);
+    const volumeSweepDir = reader.readU32(`noise[${idx}].volumeSweepDir`);
+    const volumeSweepChange = reader.readU8(`noise[${idx}].volumeSweepChange`);
+    // Skip unused fields
+    reader.readU32(`noise[${idx}].unused_a`);
+    reader.readU32(`noise[${idx}].unused_b`);
+    reader.readU32(`noise[${idx}].unused_c`);
+    reader.readU8(`noise[${idx}].unused_d`);
+    reader.readU32(`noise[${idx}].unused_e`);
+    reader.readU32(`noise[${idx}].unused_f`);
+    reader.readU32(`noise[${idx}].noise_mode`);
+    let noiseMode;
+    let subpatternEnabled;
+    let rows;
+    if (version < 6) {
+        // v5 has additional unused fields and always includes rows
+        rows = parseSubPatternRows(reader, version, `noise[${idx}]`);
+    }
+    else {
+        // v6: subpattern flag, then 64 rows × 17 bytes (always present in binary)
+        subpatternEnabled = reader.readBool(`noise[${idx}].subpatternEnabled`);
+        // Always skip 64 rows × 17 bytes = 1088 bytes (they're always written)
+        reader.skip(64 * 17);
+    }
+    return {
+        type: InstrumentType.NOISE,
+        name,
+        length,
+        lengthEnabled,
+        initialVolume,
+        volumeSweepDir,
+        volumeSweepChange,
+        noiseMode,
+        subpatternEnabled,
+        rows
+    };
+}
+function parseWavetables(reader, version) {
+    const waves = [];
+    for (let w = 0; w < 16; w++) {
+        const nibbles = [];
+        for (let i = 0; i < 32; i++) {
+            nibbles.push(reader.readU8(`wavetable[${w}].nibble[${i}]`));
+        }
+        waves.push(nibbles);
+    }
+    // v<3 has an off-by-one filler byte
+    if (version < 3) {
+        reader.readU8('wavetable.off_by_one_filler');
+    }
+    return waves;
+}
+function parsePatterns(reader, version) {
+    const initialTicksPerRow = reader.readU32('patterns.initialTicksPerRow');
+    let timerTempoEnabled;
+    let timerTempoDivider;
+    if (version >= 6) {
+        timerTempoEnabled = reader.readBool('patterns.timerTempoEnabled');
+        timerTempoDivider = reader.readU32('patterns.timerTempoDivider');
+    }
+    const numPatterns = reader.readU32('patterns.numPatterns');
+    const patterns = [];
+    for (let p = 0; p < numPatterns; p++) {
+        const index = reader.readU32(`pattern[${p}].index`);
+        const rows = [];
+        for (let r = 0; r < 64; r++) {
+            const note = reader.readU32(`pattern[${p}].row[${r}].note`);
+            const instrument = reader.readU32(`pattern[${p}].row[${r}].instrument`);
+            // v6 has an unused u32 field
+            if (version >= 6) {
+                reader.readU32(`pattern[${p}].row[${r}].unused_v6`);
+            }
+            const effectCode = reader.readU32(`pattern[${p}].row[${r}].effectCode`);
+            const effectParam = reader.readU8(`pattern[${p}].row[${r}].effectParam`);
+            rows.push({ note, instrument, effectCode, effectParam });
+        }
+        patterns.push({ index, rows });
+    }
+    return { initialTicksPerRow, timerTempoEnabled, timerTempoDivider, patterns };
+}
+function parseOrders(reader) {
+    const channels = [];
+    const channelNames = ['Duty1', 'Duty2', 'Wave', 'Noise'];
+    for (let c = 0; c < 4; c++) {
+        const orderLenPlusOne = reader.readU32(`orders[${channelNames[c]}].lengthPlusOne`);
+        const orderLen = Math.max(0, orderLenPlusOne - 1);
+        const indices = [];
+        for (let i = 0; i < orderLen; i++) {
+            const idx = reader.readU32(`orders[${channelNames[c]}].index[${i}]`);
+            const filler = reader.readU32(`orders[${channelNames[c]}].filler[${i}]`);
+            indices.push(idx);
+        }
+        channels.push(indices);
+    }
+    return {
+        duty1: channels[0],
+        duty2: channels[1],
+        wave: channels[2],
+        noise: channels[3]
+    };
+}
+function parseRoutines(reader) {
+    const routines = [];
+    for (let i = 0; i < 16; i++) {
+        const code = reader.readString(`routine[${i}]`);
+        routines.push(code);
+    }
+    return routines;
+}
+// ============================================================================
+// Main Parsing Functions
+// ============================================================================
+/**
+ * Parse a UGE file from a Buffer
+ */
+export function parseUGE(data) {
+    const reader = new BinaryReader(data);
+    // Read header
+    const version = reader.readU32('header.version');
+    // Validate version
+    if (version < 5 || version > 6) {
+        throw new Error(`Unsupported UGE version ${version}. This parser supports only v5 or v6 files.`);
+    }
+    const name = reader.readShortString('header.name');
+    const artist = reader.readShortString('header.artist');
+    const comment = reader.readShortString('header.comment');
+    // Parse instruments
+    const dutyInstruments = [];
+    for (let i = 0; i < 15; i++) {
+        dutyInstruments.push(parseDutyInstrument(reader, version, i));
+    }
+    const waveInstruments = [];
+    for (let i = 0; i < 15; i++) {
+        waveInstruments.push(parseWaveInstrument(reader, version, i));
+    }
+    const noiseInstruments = [];
+    for (let i = 0; i < 15; i++) {
+        noiseInstruments.push(parseNoiseInstrument(reader, version, i));
+    }
+    // Parse wavetables
+    const wavetables = parseWavetables(reader, version);
+    // Parse patterns
+    const { initialTicksPerRow, timerTempoEnabled, timerTempoDivider, patterns } = parsePatterns(reader, version);
+    // Parse orders
+    const orders = parseOrders(reader);
+    // Parse routines
+    const routines = parseRoutines(reader);
+    return {
+        version,
+        name,
+        artist,
+        comment,
+        dutyInstruments,
+        waveInstruments,
+        noiseInstruments,
+        wavetables,
+        initialTicksPerRow,
+        timerTempoEnabled,
+        timerTempoDivider,
+        patterns,
+        orders,
+        routines
+    };
+}
+/**
+ * Read and parse a UGE file from disk
+ */
+export function readUGEFile(path) {
+    const buffer = readFileSync(path);
+    return parseUGE(buffer);
+}
+/**
+ * Convert MIDI note number to hUGETracker note index
+ * hUGETracker uses indices 0-72 where 0 = C-3, 12 = C-4, 24 = C-5, etc.
+ */
+export function midiNoteToUGE(midi) {
+    return midi - 36; // Offset by 3 octaves (MIDI note 36 = C2 = UGE C-3)
+}
+/**
+ * Convert hUGETracker note index to note name string
+ */
+export function ugeNoteToString(uge) {
+    if (uge === 90)
+        return '...'; // Empty note
+    if (uge < 0 || uge > 72)
+        return '???';
+    const noteNames = ['C-', 'C#', 'D-', 'D#', 'E-', 'F-', 'F#', 'G-', 'G#', 'A-', 'A#', 'B-'];
+    const octave = Math.floor(uge / 12) + 3;
+    const note = noteNames[uge % 12];
+    return `${note}${octave}`;
+}
+/**
+ * Get a summary string of the UGE song
+ */
+export function getUGESummary(song) {
+    const lines = [];
+    lines.push(`=== UGE v${song.version} ===`);
+    lines.push(`Title: ${song.name}`);
+    lines.push(`Artist: ${song.artist}`);
+    if (song.comment)
+        lines.push(`Comment: ${song.comment}`);
+    lines.push(`Ticks/Row: ${song.initialTicksPerRow} (≈${Math.round(896 / song.initialTicksPerRow)} BPM)`);
+    lines.push(`Patterns: ${song.patterns.length}`);
+    lines.push(`Orders: D1=${song.orders.duty1.length}, D2=${song.orders.duty2.length}, W=${song.orders.wave.length}, N=${song.orders.noise.length}`);
+    // Count used instruments
+    const usedDuty = song.dutyInstruments.filter(i => i.name && i.name.trim()).length;
+    const usedWave = song.waveInstruments.filter(i => i.name && i.name.trim()).length;
+    const usedNoise = song.noiseInstruments.filter(i => i.name && i.name.trim()).length;
+    lines.push(`Instruments: ${usedDuty} duty, ${usedWave} wave, ${usedNoise} noise`);
+    return lines.join('\n');
+}
+/**
+ * Convert UGE song to a detailed JSON representation
+ * This provides a comprehensive breakdown similar to .bax file inspection
+ */
+export function getUGEDetailedJSON(song) {
+    // Convert patterns to human-readable format with note names
+    const patternsDetailed = song.patterns.map(pattern => ({
+        index: pattern.index,
+        rows: pattern.rows.map(row => ({
+            note: row.note === 90 ? '...' : ugeNoteToString(row.note),
+            noteIndex: row.note,
+            instrument: row.instrument,
+            effectCode: row.effectCode,
+            effectParam: row.effectParam,
+            effectDisplay: row.effectCode === 0 ? '...' :
+                `${row.effectCode.toString(16).toUpperCase()}${row.effectParam.toString(16).toUpperCase().padStart(2, '0')}`
+        }))
+    }));
+    // Filter instruments to show only those with names
+    const dutyInstrumentsFiltered = song.dutyInstruments
+        .map((inst, idx) => ({ ...inst, index: idx }))
+        .filter(inst => inst.name && inst.name.trim());
+    const waveInstrumentsFiltered = song.waveInstruments
+        .map((inst, idx) => ({ ...inst, index: idx }))
+        .filter(inst => inst.name && inst.name.trim());
+    const noiseInstrumentsFiltered = song.noiseInstruments
+        .map((inst, idx) => ({ ...inst, index: idx }))
+        .filter(inst => inst.name && inst.name.trim());
+    // Format wavetables as hex strings for readability
+    const wavetablesFormatted = song.wavetables.map((wave, idx) => ({
+        index: idx,
+        nibbles: wave,
+        hex: wave.map(n => n.toString(16).toUpperCase()).join(' ')
+    }));
+    const detailed = {
+        version: song.version,
+        metadata: {
+            name: song.name,
+            artist: song.artist,
+            comment: song.comment
+        },
+        tempo: {
+            ticksPerRow: song.initialTicksPerRow,
+            approximateBPM: Math.round(896 / song.initialTicksPerRow),
+            timerTempoEnabled: song.timerTempoEnabled,
+            timerTempoDivider: song.timerTempoDivider
+        },
+        instruments: {
+            duty: dutyInstrumentsFiltered.map(inst => ({
+                index: inst.index,
+                name: inst.name,
+                type: 'duty',
+                length: inst.length,
+                lengthEnabled: inst.lengthEnabled,
+                initialVolume: inst.initialVolume,
+                volumeSweep: {
+                    direction: inst.volumeSweepDir === 0 ? 'increase' : 'decrease',
+                    change: inst.volumeSweepChange
+                },
+                frequencySweep: {
+                    time: inst.freqSweepTime,
+                    enabled: inst.sweepEnabled === 1,
+                    shift: inst.freqSweepShift
+                },
+                dutyCycle: inst.dutyCycle,
+                dutyCyclePercent: [12.5, 25, 50, 75][inst.dutyCycle] || 50,
+                subpatternEnabled: inst.subpatternEnabled,
+                hasSubpatternRows: inst.rows && inst.rows.length > 0
+            })),
+            wave: waveInstrumentsFiltered.map(inst => ({
+                index: inst.index,
+                name: inst.name,
+                type: 'wave',
+                length: inst.length,
+                lengthEnabled: inst.lengthEnabled,
+                volume: inst.volume,
+                volumePercent: [0, 100, 50, 25][inst.volume] || 100,
+                waveIndex: inst.waveIndex,
+                subpatternEnabled: inst.subpatternEnabled,
+                hasSubpatternRows: inst.rows && inst.rows.length > 0
+            })),
+            noise: noiseInstrumentsFiltered.map(inst => ({
+                index: inst.index,
+                name: inst.name,
+                type: 'noise',
+                length: inst.length,
+                lengthEnabled: inst.lengthEnabled,
+                initialVolume: inst.initialVolume,
+                volumeSweep: {
+                    direction: inst.volumeSweepDir === 0 ? 'increase' : 'decrease',
+                    change: inst.volumeSweepChange
+                },
+                noiseMode: inst.noiseMode,
+                noiseModeDescription: inst.noiseMode === 0 ? '15-bit' : inst.noiseMode === 1 ? '7-bit' : 'unknown',
+                subpatternEnabled: inst.subpatternEnabled,
+                hasSubpatternRows: inst.rows && inst.rows.length > 0
+            }))
+        },
+        wavetables: wavetablesFormatted,
+        patterns: patternsDetailed,
+        orders: {
+            duty1: song.orders.duty1,
+            duty2: song.orders.duty2,
+            wave: song.orders.wave,
+            noise: song.orders.noise,
+            maxLength: Math.max(song.orders.duty1.length, song.orders.duty2.length, song.orders.wave.length, song.orders.noise.length)
+        },
+        routines: song.routines.map((code, idx) => ({
+            index: idx,
+            code: code,
+            hasCode: code && code.length > 0
+        })).filter(r => r.hasCode),
+        statistics: {
+            totalPatterns: song.patterns.length,
+            totalInstruments: dutyInstrumentsFiltered.length + waveInstrumentsFiltered.length + noiseInstrumentsFiltered.length,
+            dutyInstruments: dutyInstrumentsFiltered.length,
+            waveInstruments: waveInstrumentsFiltered.length,
+            noiseInstruments: noiseInstrumentsFiltered.length,
+            wavetablesUsed: song.wavetables.filter((w, idx) => waveInstrumentsFiltered.some(inst => inst.waveIndex === idx)).length,
+            songLength: {
+                duty1: song.orders.duty1.length,
+                duty2: song.orders.duty2.length,
+                wave: song.orders.wave.length,
+                noise: song.orders.noise.length
+            }
+        }
+    };
+    return JSON.stringify(detailed, null, 2);
+}
+export default { parseUGE, readUGEFile, midiNoteToUGE, ugeNoteToString, getUGESummary, getUGEDetailedJSON };
+//# sourceMappingURL=uge.reader.js.map

package/dist/import/uge/uge.reader.js.map

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

package/dist/import/urlUtils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * URL utilities for remote instrument imports.
+ * Handles URL detection, GitHub shorthand expansion, and validation.
+ */
+/**
+ * Check if an import source is a remote URL.
+ */
+export declare function isRemoteImport(source: string): boolean;
+/**
+ * Check if an import source is a local file import.
+ */
+export declare function isLocalImport(source: string): boolean;
+/**
+ * Extract the file path from a local import.
+ * @example
+ * extractLocalPath('local:lib/common.ins') => 'lib/common.ins'
+ */
+export declare function extractLocalPath(source: string): string;
+/**
+ * Expand GitHub shorthand syntax to a full raw.githubusercontent.com URL.
+ * @example
+ * expandGitHubShorthand('github:user/repo/main/file.ins')
+ * => 'https://raw.githubusercontent.com/user/repo/main/file.ins'
+ */
+export declare function expandGitHubShorthand(source: string): string;
+/**
+ * Normalize a remote import URL.
+ * - Expands GitHub shorthand
+ * - Validates protocol
+ * - Returns the canonical URL
+ */
+export declare function normalizeRemoteUrl(source: string): string;
+/**
+ * Security options for remote imports.
+ */
+export interface RemoteImportSecurityOptions {
+    /** Only allow HTTPS URLs (recommended for production) */
+    httpsOnly?: boolean;
+    /** Maximum file size in bytes (default: 1MB) */
+    maxFileSize?: number;
+    /** Request timeout in milliseconds (default: 10000ms) */
+    timeout?: number;
+    /** Allowed domains (empty array = all domains allowed) */
+    allowedDomains?: string[];
+}
+/**
+ * Validate a remote URL against security constraints.
+ */
+export declare function validateRemoteUrl(url: string, options?: RemoteImportSecurityOptions): void;
+//# sourceMappingURL=urlUtils.d.ts.map

package/dist/import/urlUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlUtils.d.ts","sourceRoot":"","sources":["../../src/import/urlUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,2BAAgC,GACxC,IAAI,CA+BN"}