@audiofab-io/fv1-core 0.2.3 → 0.4.0

package/dist/blockDiagram/compiler/GraphCompiler.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Main graph compiler
+ * Orchestrates the compilation of a block diagram to FV-1 assembly
+ */
+import { BlockGraph } from '../types/Graph.js';
+import { BlockRegistry } from '../blocks/BlockRegistry.js';
+import { OptimizationLevel } from './CodeOptimizer.js';
+export interface CompilationStatistics {
+    instructionsUsed: number;
+    registersUsed: number;
+    memoryUsed: number;
+    blocksProcessed: number;
+    lfosUsed: number;
+    usedLFOs?: string[];
+}
+export interface CompilationResult {
+    success: boolean;
+    assembly?: string;
+    statistics?: CompilationStatistics;
+    errors?: string[];
+    warnings?: string[];
+}
+export declare class GraphCompiler {
+    private registry;
+    private topologicalSort;
+    private optimizer;
+    constructor(registry: BlockRegistry);
+    /**
+     * Compile a block diagram to FV-1 assembly code
+     */
+    compile(graph: BlockGraph, options: {
+        regCount: number;
+        progSize: number;
+        delaySize: number;
+        fv1AsmMemBug?: boolean;
+        clampReals?: boolean;
+        optimizationLevel?: OptimizationLevel;
+    }): CompilationResult;
+    /**
+     * Generate a descriptive comment block for a block's code section
+     */
+    private generateBlockComment;
+    /**
+     * Validate the graph structure
+     */
+    private validateGraph;
+    /**
+     * Generate pot mapping comments showing which parameters each pot controls
+     */
+    private generatePotMappingComments;
+    /**
+     * Pre-allocate registers for all connected outputs
+     * This ensures registers exist before any code generation, which is necessary
+     * for feedback loops where blocks may need to read from outputs that haven't
+     * been generated yet in the execution order
+     */
+    private preallocateAllOutputs;
+    /**
+     * Process semantic IR nodes and optimize assembly
+     */
+    private processIR;
+}
+//# sourceMappingURL=GraphCompiler.d.ts.map

package/dist/blockDiagram/compiler/GraphCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphCompiler.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/compiler/GraphCompiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAiB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGtE,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAgB;gBAErB,QAAQ,EAAE,aAAa;IAMnC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACzC,GAAG,iBAAiB;IA4TrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkE5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqJrB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0DlC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,SAAS;CA8HpB"}