@audiofab-io/fv1-core 0.2.2 → 0.4.0

package/dist/blockDiagram/types/IR.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Core types for the new Semantic Intermediate Representation (IR)
+ * and Declarative Block Templates.
+ */
+export type IRSection = 'init' | 'input' | 'main' | 'output' | 'header';
+export interface IRNode {
+    op: string;
+    args: any[];
+    section: IRSection;
+    comment?: string;
+}
+export interface BlockPortDefinition {
+    id: string;
+    name: string;
+    type: 'audio' | 'control';
+    required?: boolean;
+    /** For control inputs: the parameter ID that backs this CV (used by @cv macro). */
+    parameter?: string;
+    description?: string;
+}
+export interface BlockTemplateDefinition {
+    type: string;
+    category: string;
+    subcategory?: string;
+    name: string;
+    description: string;
+    color?: string;
+    width?: number;
+    height?: number;
+    inputs: BlockPortDefinition[];
+    outputs: BlockPortDefinition[];
+    parameters: BlockParameterDefinition[];
+    /** Internal state registers (not exposed as ports). */
+    registers?: string[];
+    /** Internal delay memory. */
+    memories?: Array<{
+        id: string;
+        size: number | string;
+    }>;
+    /** Optional template for the block label in the UI. */
+    labelTemplate?: string;
+    /** The ATL template string. */
+    template: string;
+    /** Raw ATL source retained by the registry parser; not emitted by hand-authored JSON defs. */
+    _rawAtl?: string;
+}
+export interface BlockParameterDefinition {
+    id: string;
+    name: string;
+    type: 'number' | 'select' | 'boolean' | 'string';
+    default: any;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+    description?: string;
+    /**
+     * Value conversion applied at code-gen time. The built-in names are
+     * recognized by the compiler; strings outside this list are accepted
+     * for forward compatibility (custom conversions defined by new ATL blocks).
+     */
+    conversion?: string;
+    displayUnit?: string;
+    displayMin?: number;
+    displayMax?: number;
+    displayDecimals?: number;
+    /** TypeScript expression for custom conversion. */
+    eval?: string;
+    /** Conditional visibility expression (evaluated by the editor UI). */
+    visibleIf?: string;
+    /** If true, the parameter editor uses a multi-line text field. */
+    multiline?: boolean;
+    /** Optional UI label template for this parameter's value display. */
+    labelTemplate?: string;
+}
+//# sourceMappingURL=IR.d.ts.map

package/dist/blockDiagram/types/IR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IR.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/types/IR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,GAAG,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/blockDiagram/types/IR.js

@@ -0,0 +1,6 @@
+/**
+ * Core types for the new Semantic Intermediate Representation (IR)
+ * and Declarative Block Templates.
+ */
+export {};
+//# sourceMappingURL=IR.js.map

package/dist/blockDiagram/types/IR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IR.js","sourceRoot":"","sources":["../../../src/blockDiagram/types/IR.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/blockDiagram/utils/SpinCADConverter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SpinCADConverter
+ * Parses .spincad files and generates JSON or ATL (Frontmatter) block definitions.
+ */
+import { BlockTemplateDefinition } from '../types/IR.js';
+export declare class SpinCADConverter {
+    /**
+     * Convert a SpinCAD template string to an ATL BlockTemplateDefinition
+     * Metadata is extracted from @ directives.
+     */
+    static convert(content: string, typeOverride?: string, sourceFile?: string): BlockTemplateDefinition;
+    /**
+     * Format a definition as an ATL file with JSON frontmatter
+     */
+    static toATL(definition: BlockTemplateDefinition): string;
+}
+//# sourceMappingURL=SpinCADConverter.d.ts.map

package/dist/blockDiagram/utils/SpinCADConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpinCADConverter.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/utils/SpinCADConverter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,qBAAa,gBAAgB;IACzB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB;IA4RpG;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM;CAO5D"}

package/dist/blockDiagram/utils/SpinCADConverter.js

@@ -0,0 +1,307 @@
+/**
+ * SpinCADConverter
+ * Parses .spincad files and generates JSON or ATL (Frontmatter) block definitions.
+ */
+export class SpinCADConverter {
+    /**
+     * Convert a SpinCAD template string to an ATL BlockTemplateDefinition
+     * Metadata is extracted from @ directives.
+     */
+    static convert(content, typeOverride, sourceFile) {
+        const lines = content.split('\n');
+        const definition = {
+            type: typeOverride || '',
+            category: 'SpinCAD',
+            name: '',
+            description: '',
+            inputs: [],
+            outputs: [],
+            parameters: [],
+            template: ''
+        };
+        const headerLines = [];
+        if (sourceFile) {
+            headerLines.push(`@comment "Generated from spincad source file ${sourceFile}"`);
+        }
+        const bodyLines = [];
+        const managedRegs = [];
+        const managedMemories = [];
+        const managedEqus = [];
+        for (let line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed.startsWith('@')) {
+                const parts = trimmed.match(/[^\s"']+|"([^"]*)"|'([^']*)'/g)?.map(m => m.replace(/^["']|["']$/g, '')) || [];
+                if (parts.length === 0)
+                    continue;
+                const directive = parts[0].substring(1);
+                switch (directive) {
+                    case 'name':
+                        definition.name = parts.slice(1).join(' ');
+                        if (!typeOverride) {
+                            definition.type = definition.name.toLowerCase()
+                                .replace(/[^a-z0-9]+/g, '_')
+                                .replace(/^_+|_+$/g, '');
+                        }
+                        break;
+                    case 'color':
+                        definition.color = parts[1].replace(/"/g, '').replace('0x', '#');
+                        break;
+                    case 'audioInput':
+                        definition.inputs.push({
+                            id: parts[1],
+                            name: parts[2] || parts[1],
+                            type: 'audio'
+                        });
+                        break;
+                    case 'audioOutput':
+                    case 'controlOutput':
+                        definition.outputs.push({
+                            id: parts[1],
+                            name: parts[2] || parts[1],
+                            type: directive === 'audioOutput' ? 'audio' : 'control'
+                        });
+                        break;
+                    case 'controlInput':
+                        definition.inputs.push({
+                            id: parts[1],
+                            name: parts[2] || parts[1],
+                            type: 'control'
+                        });
+                        break;
+                    case 'sliderLabel': {
+                        let min = parseFloat(parts[3]);
+                        let max = parseFloat(parts[4]);
+                        let def = parseFloat(parts[5]);
+                        const conversionType = parts[8];
+                        // SpinCAD supplies parameters in native samples (0 to 32768).
+                        // FV-1 VSCode interprets `LENGTHTOTIME` on sliders via milliseconds and reconverts them.
+                        // We scale the UI limits on these custom blocks to match this expectation.
+                        if (conversionType === 'LENGTHTOTIME') {
+                            const Fs = 32768;
+                            min = Math.round((min / Fs) * 1000);
+                            max = Math.round((max / Fs) * 1000);
+                            def = Math.round((def / Fs) * 1000);
+                        }
+                        definition.parameters.push({
+                            id: parts[1],
+                            name: (parts[2] || '').replace(/'/g, ''),
+                            type: 'number',
+                            min: min,
+                            max: max,
+                            default: def,
+                            conversion: conversionType
+                        });
+                        break;
+                    }
+                    case 'comboBox':
+                        definition.parameters.push({
+                            id: parts[1],
+                            name: parts[1],
+                            type: 'select',
+                            default: 0,
+                            options: parts.slice(2).map((o, idx) => ({ label: o.replace(/'/g, ''), value: idx }))
+                        });
+                        break;
+                    case 'isPinConnected':
+                        bodyLines.push(`@if pinConnected(${parts[1]})`);
+                        break;
+                    case 'isEqualTo':
+                        bodyLines.push(`@if ${parts[1]} == ${parts[2]}`);
+                        break;
+                    case 'else':
+                        bodyLines.push('@else');
+                        break;
+                    case 'endif':
+                        bodyLines.push('@endif');
+                        break;
+                    case 'setOutputPin':
+                        // Legacy directive, ignore
+                        break;
+                    case 'equ':
+                        const eqId = parts[1];
+                        const eqVal = parts[2];
+                        const isPinEq = definition.inputs.some(i => i.id === eqId) || definition.outputs.some(o => o.id === eqId);
+                        if (!isPinEq) {
+                            if (eqVal && eqVal.toLowerCase().startsWith('reg')) {
+                                managedRegs.push(eqId);
+                            }
+                            else {
+                                headerLines.push(`${directive}\t${parts.slice(1).join('\t')}`);
+                            }
+                        }
+                        break;
+                    case 'mem':
+                        const mId = parts[1];
+                        const sizePart = parts[2];
+                        const mSize = isNaN(Number(sizePart)) ? sizePart : parseInt(sizePart);
+                        managedMemories.push({ id: mId, size: mSize });
+                        break;
+                    case 'getDelayScaleControl':
+                        // @getDelayScaleControl tap1Ratio delayLength delayOffset 
+                        // -> sof ${tap1Ratio}, 0
+                        // -> sof ${delayLength} / 32768, (${mem.delayl} + 1) / 32768
+                        const baseOffsetExpr = managedMemories.length > 0 ? `(\${mem.${managedMemories[0].id}} + 1)` : `\${${parts[3]}}`;
+                        bodyLines.push(`sof\t\${${parts[1]}}, 0`);
+                        bodyLines.push(`sof\t\${${parts[2]}} / 32768, ${baseOffsetExpr} / 32768`);
+                        break;
+                    case 'getSamplesFromRatio':
+                        // @getSamplesFromRatio ratio tap1Ratio delayLength
+                        // Emits a constant calculation into the assembler
+                        // SpinCAD internally tracks this for GUI mapping. For ATL, we can just defer it 
+                        // by creating an inline equation. i.e `equ ratio tap1Ratio * delayLength`
+                        // (The FV-1 assembler will precalculate constant arithmetic if it has values)
+                        managedEqus.push(parts[1]);
+                        bodyLines.push(`equ\t${parts[1]}\t\${${parts[2]}} * \${${parts[3]}}`);
+                        break;
+                    case 'minusDouble':
+                    case 'multiplyDouble':
+                    case 'plusDouble':
+                    case 'multiplyInt':
+                    case 'divideDouble':
+                    case 'divideInt':
+                        managedEqus.push(parts[1]);
+                        headerLines.push(trimmed);
+                        break;
+                    case 'getBaseAddress':
+                        managedEqus.push('delayOffset');
+                        bodyLines.push('equ\tdelayOffset\t-1');
+                        break;
+                    case 'readChorusTap': {
+                        // @readChorusTap lfoSel 0 tap1Center delayLength delayOffset 
+                        const lfo = parts[1];
+                        const instance = parts[2];
+                        const center = parts[3];
+                        const depth = parts[4];
+                        const offset = parts[5];
+                        let lfoName = `SIN${instance}`;
+                        if (instance === '2')
+                            lfoName = 'COS0';
+                        if (instance === '3')
+                            lfoName = 'COS1';
+                        bodyLines.push(`cho\trda,\t${lfoName},\tREG | COMPC,\t\${${offset}}`);
+                        bodyLines.push(`cho\trda,\t${lfoName},\t0,\t\${${offset}} + 1`);
+                        break;
+                    }
+                    default:
+                        // Keep other directives.
+                        bodyLines.push(trimmed);
+                }
+            }
+            else {
+                // Assembly line
+                const trimmedLine = line.trim();
+                const lineParts = trimmedLine.split(/[,\s\t]+/);
+                const op = lineParts[0].toLowerCase();
+                if (op === 'equ') {
+                    const eqId = lineParts[1];
+                    const eqVal = lineParts[2];
+                    const isPinEq = definition.inputs.some(i => i.id === eqId) || definition.outputs.some(o => o.id === eqId);
+                    if (!isPinEq) {
+                        if (eqVal && eqVal.toLowerCase().startsWith('reg')) {
+                            managedRegs.push(eqId);
+                        }
+                        else {
+                            headerLines.push(line);
+                        }
+                    }
+                }
+                else if (op === 'mem') {
+                    const memId = lineParts[1];
+                    const sizeStr = lineParts[2];
+                    const memSize = isNaN(Number(sizeStr)) ? sizeStr : parseInt(sizeStr);
+                    managedMemories.push({ id: memId, size: memSize });
+                }
+                else if (lineParts[0].toLowerCase() === 'offset') {
+                    // "offset ratio 1" => "equ offset ratio" + something?
+                    // In MN3011a, it simply assigns the variable 'ratio' to 'ratio + 1' ?
+                    // Or it allocates an offset. "offset ratio 1" means ratio is an offset of 1? 
+                    // Actually, looking at the code, it probably means "equ offset ratio_1" or "offset" is a type.
+                    // Let's replace it with a valid equ to assign a constant or let it be redefined later.
+                    managedEqus.push(lineParts[1]);
+                    bodyLines.push(`equ\t${lineParts[1]}\t${lineParts[2] || '0'}`);
+                }
+                else if (op === 'bool' || op === 'int') {
+                    // Ignore metadata declarations that ended up in the body
+                }
+                else {
+                    bodyLines.push(line);
+                }
+            }
+        }
+        if (managedRegs.length > 0)
+            definition.registers = managedRegs;
+        if (managedMemories.length > 0)
+            definition.memories = managedMemories;
+        const templateLines = [];
+        if (headerLines.length > 0) {
+            const filteredHeaders = headerLines.filter(line => {
+                const parts = line.trim().split(/\s+/);
+                if (parts[0].toLowerCase() === 'equ' || parts[0].toLowerCase() === '@equ') {
+                    const eqId = parts[1];
+                    if (definition.parameters.some(p => p.id === eqId)) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+            if (filteredHeaders.length > 0) {
+                templateLines.push('@section header');
+                templateLines.push(...filteredHeaders);
+                templateLines.push('');
+            }
+        }
+        if (bodyLines.length > 0) {
+            if (headerLines.length > 0) {
+                templateLines.push('@section main');
+            }
+            templateLines.push(...bodyLines);
+        }
+        // Variable substitution pass: Replace raw IDs with ${type.id} tokens
+        const ids = {
+            input: definition.inputs.map(i => i.id),
+            output: definition.outputs.map(o => o.id),
+            param: definition.parameters.map(p => p.id),
+            local: managedRegs,
+            memories: managedMemories.map(m => m.id)
+        };
+        let processedTemplate = templateLines.join('\n');
+        // Replace whole words only to avoid partial matches
+        // Handle +/- suffixes by inserting a space
+        const replaceToken = (id, target) => {
+            const regex = new RegExp(`\\b${id}\\b(?![^\\{]*\\})`, 'gi');
+            processedTemplate = processedTemplate.replace(regex, (match, offset, string) => {
+                const nextChar = string[offset + match.length];
+                if (nextChar === '+' || nextChar === '-') {
+                    return target + ' ';
+                }
+                return target;
+            });
+        };
+        for (const id of ids.input)
+            replaceToken(id, `\${input.${id}}`);
+        for (const id of ids.output)
+            replaceToken(id, `\${output.${id}}`);
+        for (const id of ids.param)
+            replaceToken(id, `\${${id}}`);
+        for (const id of ids.local)
+            replaceToken(id, `\${reg.${id}}`);
+        for (const id of ids.memories)
+            replaceToken(id, `\${mem.${id}}`);
+        for (const id of managedEqus)
+            replaceToken(id, `\${local.${id}}`);
+        definition.template = processedTemplate;
+        return definition;
+    }
+    /**
+     * Format a definition as an ATL file with JSON frontmatter
+     */
+    static toATL(definition) {
+        const metadata = { ...definition };
+        const template = metadata.template;
+        delete metadata.template;
+        return `---\n${JSON.stringify(metadata, null, 2)}\n---\n${template}`;
+    }
+}
+//# sourceMappingURL=SpinCADConverter.js.map

package/dist/blockDiagram/utils/SpinCADConverter.js.map

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

package/dist/effect/compileEffect.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Unified compile entry: given an effect source in one of three formats,
+ * return a 512-byte FV-1 program binary ready to write to EEPROM.
+ *
+ * Supported inputs:
+ *   - 'spn'        SpinAsm source text
+ *   - 'hex'        Intel HEX, optionally a single slot selected via `slot`
+ *   - 'spndiagram' JSON block-diagram document
+ *
+ * The spndiagram path uses a BlockRegistry. If none is supplied, a fresh
+ * registry is created and loaded with BUILTIN_BLOCKS.
+ */
+import { FV1AssemblerProblem } from '../assembler/FV1Assembler.js';
+import { BlockRegistry } from '../blockDiagram/blocks/BlockRegistry.js';
+import { BlockGraph } from '../blockDiagram/types/Graph.js';
+/** FV-1 program size in bytes (128 instructions × 4 bytes). */
+export declare const PROGRAM_SIZE_BYTES = 512;
+export type EffectFormat = 'spn' | 'hex' | 'spndiagram';
+export type EffectSource = {
+    format: 'spn';
+    source: string;
+} | {
+    format: 'hex';
+    source: string;
+    slot?: number;
+} | {
+    format: 'spndiagram';
+    source: string | BlockGraph;
+};
+export interface CompileEffectOptions {
+    /** Block registry for spndiagram sources. Defaults to one preloaded with BUILTIN_BLOCKS. */
+    registry?: BlockRegistry;
+    /** FV-1 assembler options passed through when assembling SPN or diagram output. */
+    fv1AsmMemBug?: boolean;
+    clampReals?: boolean;
+}
+export interface CompileEffectResult {
+    binary: Uint8Array;
+    /** Generated SpinAsm source (always present for 'spn' and 'spndiagram'; undefined for 'hex'). */
+    assembly?: string;
+    problems?: FV1AssemblerProblem[];
+    warnings?: string[];
+}
+/** Detect format from a filename's extension. Throws on unknown extensions. */
+export declare function formatFromFilename(filename: string): EffectFormat;
+/**
+ * Compile any supported effect source into a 512-byte FV-1 program binary.
+ * Throws if the source can't be compiled (syntax errors, invalid graph, etc).
+ */
+export declare function compileEffect(src: EffectSource, options?: CompileEffectOptions): CompileEffectResult;
+//# sourceMappingURL=compileEffect.d.ts.map

package/dist/effect/compileEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileEffect.d.ts","sourceRoot":"","sources":["../../src/effect/compileEffect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,CAAC;AAExD,MAAM,MAAM,YAAY,GAClB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAMjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CASxG"}

package/dist/effect/compileEffect.js

@@ -0,0 +1,133 @@
+/**
+ * Unified compile entry: given an effect source in one of three formats,
+ * return a 512-byte FV-1 program binary ready to write to EEPROM.
+ *
+ * Supported inputs:
+ *   - 'spn'        SpinAsm source text
+ *   - 'hex'        Intel HEX, optionally a single slot selected via `slot`
+ *   - 'spndiagram' JSON block-diagram document
+ *
+ * The spndiagram path uses a BlockRegistry. If none is supplied, a fresh
+ * registry is created and loaded with BUILTIN_BLOCKS.
+ */
+import { FV1Assembler } from '../assembler/FV1Assembler.js';
+import { IntelHexParser } from '../hex/IntelHexParser.js';
+import { BlockRegistry } from '../blockDiagram/blocks/BlockRegistry.js';
+import { BUILTIN_BLOCKS } from '../blockDiagram/builtinBlocks.js';
+import { GraphCompiler } from '../blockDiagram/compiler/GraphCompiler.js';
+/** FV-1 program size in bytes (128 instructions × 4 bytes). */
+export const PROGRAM_SIZE_BYTES = 512;
+/** Detect format from a filename's extension. Throws on unknown extensions. */
+export function formatFromFilename(filename) {
+    const lower = filename.toLowerCase();
+    if (lower.endsWith('.spn'))
+        return 'spn';
+    if (lower.endsWith('.hex'))
+        return 'hex';
+    if (lower.endsWith('.spndiagram'))
+        return 'spndiagram';
+    throw new Error(`Unknown effect file extension: ${filename}`);
+}
+/**
+ * Compile any supported effect source into a 512-byte FV-1 program binary.
+ * Throws if the source can't be compiled (syntax errors, invalid graph, etc).
+ */
+export function compileEffect(src, options = {}) {
+    switch (src.format) {
+        case 'spn':
+            return compileSpn(src.source, options);
+        case 'hex':
+            return compileHex(src.source, src.slot);
+        case 'spndiagram':
+            return compileDiagram(src.source, options);
+    }
+}
+function compileSpn(source, options) {
+    const assembler = new FV1Assembler({
+        fv1AsmMemBug: options.fv1AsmMemBug,
+        clampReals: options.clampReals,
+    });
+    const result = assembler.assemble(source);
+    const fatal = result.problems.filter(p => p.isfatal);
+    if (fatal.length > 0) {
+        const summary = fatal.map(p => `line ${p.line}: ${p.message}`).join('; ');
+        throw new Error(`SPN assembly failed: ${summary}`);
+    }
+    const binary = padToProgramSize(FV1Assembler.toUint8Array(result.machineCode));
+    return {
+        binary,
+        assembly: source,
+        problems: result.problems,
+    };
+}
+function compileHex(source, slot) {
+    const full = IntelHexParser.parse(source);
+    // When no slot is specified, auto-detect: find the first 512-byte window that
+    // isn't entirely 0xFF (i.e. actually contains a program). This lets a .hex
+    // file built for slot N on an original pedal be written to any slot on the
+    // target pedal — the source slot and destination slot are decoupled.
+    const resolvedSlot = slot ?? autoDetectHexSlot(full);
+    if (resolvedSlot < 0 || resolvedSlot > 7) {
+        throw new Error(`HEX slot out of range: ${resolvedSlot} (valid: 0-7)`);
+    }
+    const offset = resolvedSlot * PROGRAM_SIZE_BYTES;
+    if (full.length <= offset) {
+        throw new Error(`HEX file does not contain slot ${resolvedSlot} (length ${full.length} bytes)`);
+    }
+    const end = offset + PROGRAM_SIZE_BYTES;
+    const binary = padToProgramSize(full.subarray(offset, Math.min(end, full.length)));
+    return { binary };
+}
+function autoDetectHexSlot(full) {
+    for (let slot = 0; slot < 8; slot++) {
+        const offset = slot * PROGRAM_SIZE_BYTES;
+        if (offset >= full.length)
+            break;
+        const end = Math.min(offset + PROGRAM_SIZE_BYTES, full.length);
+        for (let i = offset; i < end; i++) {
+            if (full[i] !== 0xFF)
+                return slot;
+        }
+    }
+    return 0;
+}
+function compileDiagram(source, options) {
+    const graph = typeof source === 'string' ? JSON.parse(source) : source;
+    const registry = options.registry ?? createDefaultRegistry();
+    const compiler = new GraphCompiler(registry);
+    const compileResult = compiler.compile(graph, {
+        regCount: 32,
+        progSize: 128,
+        delaySize: 32768,
+        fv1AsmMemBug: options.fv1AsmMemBug,
+        clampReals: options.clampReals,
+    });
+    if (!compileResult.success || !compileResult.assembly) {
+        const msg = (compileResult.errors ?? ['unknown graph compile error']).join('; ');
+        throw new Error(`Diagram compile failed: ${msg}`);
+    }
+    // Feed the generated assembly through the normal SPN path to produce the binary.
+    const asmResult = compileSpn(compileResult.assembly, options);
+    return {
+        binary: asmResult.binary,
+        assembly: compileResult.assembly,
+        problems: asmResult.problems,
+        warnings: compileResult.warnings,
+    };
+}
+function padToProgramSize(data) {
+    if (data.length === PROGRAM_SIZE_BYTES)
+        return data;
+    const out = new Uint8Array(PROGRAM_SIZE_BYTES);
+    out.set(data.subarray(0, Math.min(data.length, PROGRAM_SIZE_BYTES)));
+    return out;
+}
+let defaultRegistry;
+function createDefaultRegistry() {
+    if (!defaultRegistry) {
+        defaultRegistry = new BlockRegistry();
+        defaultRegistry.loadManifest(BUILTIN_BLOCKS);
+    }
+    return defaultRegistry;
+}
+//# sourceMappingURL=compileEffect.js.map

package/dist/effect/compileEffect.js.map

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

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export type { AlgToken, Expr, Statement } from './assembler/AlgebraicCompiler.js
 export { FV1Simulator } from './simulator/FV1Simulator.js';
 export { IntelHexParser } from './hex/IntelHexParser.js';
 export type { HexRecord } from './hex/IntelHexParser.js';
+export { compileEffect, formatFromFilename, PROGRAM_SIZE_BYTES, } from './effect/compileEffect.js';
+export type { EffectFormat, EffectSource, CompileEffectOptions, CompileEffectResult, } from './effect/compileEffect.js';
 //# sourceMappingURL=index.d.ts.map