@audiofab-io/fv1-core 0.1.0

package/dist/simulator/FV1Simulator.d.ts

@@ -0,0 +1,206 @@
+export declare class FV1Simulator {
+    private delaySize;
+    private delayMask;
+    private regCount;
+    private progSize;
+    private static readonly MAX_ACC;
+    private static readonly MIN_ACC;
+    private sin0;
+    private cos0;
+    private sin1;
+    private cos1;
+    private rmp0;
+    private rmp1;
+    private sin0_rate;
+    private sin0_range;
+    private sin1_rate;
+    private sin1_range;
+    private rmp0_rate;
+    private rmp0_range;
+    private rmp1_rate;
+    private rmp1_range;
+    private delayRam;
+    private registers;
+    private program;
+    private acc;
+    private pacc;
+    private lr;
+    private lfo;
+    private delayPointer;
+    private firstRun;
+    private pc;
+    private breakpoints;
+    private symbols;
+    private memories;
+    private fv1AsmMemBug;
+    private traceEnabled;
+    private traceWriter;
+    private cycleCount;
+    private traceCycle;
+    private traceMaxCycles;
+    private traceRowCount;
+    private traceDelayAddr;
+    private traceDelayOffset;
+    private traceDelayOp;
+    private traceDelayValue;
+    private traceInstructionPC;
+    private currentReadOffsets;
+    constructor();
+    /**
+     * Configures simulator hardware limits.
+     */
+    setCapabilities(delaySize: number, regCount: number, progSize: number): void;
+    getDelayPointer(): number;
+    getDelaySize(): number;
+    /**
+     * Loads the machine code into the simulator.
+     * @param code Array of 32-bit integers representing the assembled program.
+     */
+    loadProgram(code: Uint32Array | number[]): void;
+    /**
+     * Resets the simulator state (clears memory, registers, accumulator).
+     */
+    reset(): void;
+    /**
+     * Set breakpoints at specific instruction addresses.
+     * @param addresses Set of addresses to break at.
+     */
+    setBreakpoints(addresses: Set<number>): void;
+    /**
+     * Set symbol and memory metadata for expression evaluation.
+     */
+    setSymbols(symbols: any[], memories: any[], fv1AsmMemBug?: boolean): void;
+    /**
+     * Process a block of audio samples.
+     * Useful for real-time audio processing in AudioWorklets.
+     */
+    processBlock(inputL: Float32Array, inputR: Float32Array, outputL: Float32Array, outputR: Float32Array, pot0: number, pot1: number, pot2: number): void;
+    /**
+     * Process a single sample frame.
+     * Executes instructions until the end of the program or a breakpoint is hit.
+     * @param skipCurrentBreakpoint If true, will not break on the instruction at the current PC.
+     * @returns [outL, outR, breakpointHit]
+     */
+    step(inL: number, inR: number, pot0: number, pot1: number, pot2: number, skipCurrentBreakpoint?: boolean): [number, number, boolean];
+    private getOutputs;
+    beginFrame(inL?: number, inR?: number, pot0?: number, pot1?: number, pot2?: number): void;
+    endFrame(): [number, number];
+    /**
+     * Executes a single instruction at the current PC.
+     * @returns The next PC address.
+     */
+    stepInstruction(): number;
+    private executeInstruction;
+    private opRDA;
+    private opWRA;
+    private opWRAP;
+    private opRDAX;
+    private opWRAX;
+    private opSOF;
+    private opRMPA;
+    private opMULX;
+    private opLOG;
+    private opEXP;
+    private opRDFX;
+    private opMAXX;
+    private opSKP;
+    private opWRLX;
+    private opWRHX;
+    private opAND;
+    private opOR;
+    private opXOR;
+    private opJAM;
+    private opWLDS;
+    private opWLDR;
+    private getLfoVal;
+    private getLfoRange;
+    private opCHO;
+    private opCHO_RDA;
+    private opCHO_SOF;
+    private opCHO_RDAL;
+    getPC(): number;
+    getProgSize(): number;
+    setPC(pc: number): void;
+    setAcc(val: number): void;
+    setPacc(val: number): void;
+    /**
+     * Sets a register value with hardware-accurate saturation and quantization.
+     * @param idx Register index (0-63)
+     * @param val Raw value (float)
+     */
+    setRegister(idx: number, val: number): void;
+    /**
+     * Evaluates a string expression (register name, symbol, memory suffix).
+     * @returns { result: string, value: number } or null
+     */
+    evaluateExpression(expr: string): {
+        label: string;
+        value: number;
+    } | null;
+    getState(): {
+        pc: number;
+        acc: number;
+        pacc: number;
+        lr: number;
+        lfo: number;
+        registers: {
+            [k: string]: number;
+        };
+        flags: {
+            RUN: boolean;
+            ZRC: boolean;
+            ZRO: boolean;
+            GEZ: boolean;
+            NEG: boolean;
+        };
+        lfoState: {
+            sin0: number;
+            cos0: number;
+            sin1: number;
+            cos1: number;
+            rmp0: number;
+            rmp1: number;
+        };
+    };
+    getCycleCount(): number;
+    getReadOffsets(): number[];
+    getRegisters(): Float32Array;
+    private updateLFOs;
+    private updateStateRegisters;
+    getDelayRam(): Float32Array;
+    private decodeS1_14;
+    private decodeS1_9;
+    private decodeS_10;
+    private decodeS4_6;
+    private decodeS_15;
+    private saturate;
+    private static readonly OPCODE_NAMES;
+    private traceOnComplete;
+    /**
+     * Enable trace logging with a streaming writer callback.
+     * Each row is emitted immediately via the writer — nothing is stored in memory.
+     * @param writer Callback that receives each CSV row (including header).
+     * @param maxCycles Maximum number of sample cycles to log (0 = unlimited).
+     * @param onComplete Optional callback when trace auto-completes.
+     */
+    enableTrace(writer: (row: string) => void, maxCycles?: number, onComplete?: () => void): void;
+    /**
+     * Disable trace logging.
+     */
+    disableTrace(): void;
+    /**
+     * Returns whether trace logging is currently active.
+     */
+    isTraceEnabled(): boolean;
+    /**
+     * Returns the number of trace rows emitted so far.
+     */
+    getTraceRowCount(): number;
+    /**
+     * Called at end-of-frame to advance the trace cycle counter.
+     * If maxCycles is reached, trace is automatically disabled.
+     */
+    advanceTraceCycle(): void;
+    private logTrace;
+}
+//# sourceMappingURL=FV1Simulator.d.ts.map

package/dist/simulator/FV1Simulator.d.ts.map

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