@audiofab-io/fv1-core 0.5.0 → 0.6.1

package/blocks/control/envelope.atl

@@ -1,121 +1,121 @@
----
-{
-  "type": "control.envelope",
-  "category": "Control",
-  "name": "Envelope Follower",
-  "description": "Multi-mode envelope follower based on the SpinCAD 'Envelope' block algorithm. Outputs both a Single Slope (average) and a Dual Slope (peak with decay) follower.",
-  "labelTemplate": "",
-  "color": "#f2b824",
-  "inputs": [
-    {
-      "id": "audio",
-      "name": "Audio Input",
-      "type": "audio",
-      "required": true
-    },
-    {
-      "id": "sens",
-      "name": "Sensitivity",
-      "type": "control",
-      "required": false,
-      "parameter": "gain"
-    }
-  ],
-  "outputs": [
-    {
-      "id": "single",
-      "name": "Single Slope",
-      "type": "control"
-    },
-    {
-      "id": "dual",
-      "name": "Dual Slope",
-      "type": "control"
-    }
-  ],
-  "parameters": [
-    {
-      "id": "gain",
-      "name": "Sensitivity",
-      "type": "number",
-      "default": 1.5,
-      "min": 0.5,
-      "max": 1.99,
-      "step": 0.01,
-      "description": "Pre-detection boost (up to ~4x with internal SOF stage). Higher values make the envelope respond to quieter signals."
-    },
-    {
-      "id": "attack",
-      "name": "Attack Rate",
-      "type": "number",
-      "default": 0.78,
-      "min": 0.1,
-      "max": 20.0,
-      "step": 0.01,
-      "conversion": "LOGFREQ",
-      "description": "Corner frequency for the Single Slope (average) follower. 0.78 Hz ≈ 0.00015 coefficient."
-    },
-    {
-      "id": "decay",
-      "name": "Decay Rate",
-      "type": "number",
-      "default": 0.52,
-      "min": 0.1,
-      "max": 10.0,
-      "step": 0.01,
-      "conversion": "LOGFREQ",
-      "description": "Release frequency for the Dual Slope (peak) follower. 0.52 Hz ≈ 0.0001 coefficient."
-    }
-  ],
-  "registers": [
-    "AVG",
-    "LAVG",
-    "TEMP"
-  ]
-}
----
-; Envelope Follower
-; Based on EnvelopeControlCADBlock.java
-
-@section main
-@if pinConnected(audio)
-
-; --- Pre-Detection Boost ---
-; RDAX coefficient (up to 1.99x) + fixed SOF 2x stage = up to ~4x total headroom boost.
-rdax ${input.audio}, ${param.gain}  ; Boost via RDAX coefficient (0.5–1.99x)
-sof 1.99, 0.0                       ; Additional 2x → env covers the full 0–1 range for normal playing levels
-absa                                 ; Full-wave rectify
-@if pinConnected(sens)
-mulx ${input.sens}                   ; Pot scales overall sensitivity (0 = off, 1.0 = full)
-@endif
-
-; --- Single Slope (Average Follower) ---
-; Computes a running average of the magnitude using a first-order low-pass filter.
-rdfx ${reg.AVG}, ${param.attack}
-wrax ${reg.AVG}, 0.0            ; Clear ACC to process Dual Slope next
-
-; --- Dual Slope (Peak Follower) ---
-; Follows the peak of the average signal with an exponential decay.
-; 1. Compute decayed peak: TEMP = LAVG * (1 - decay)
-rdax ${reg.LAVG}, 1.0
-sof -${param.decay}, 0.0        ; Apply coefficient as multiplier (-decay)
-rdax ${reg.LAVG}, 1.0           ; ACC = LAVG - decay*LAVG
-wrax ${reg.TEMP}, 0.0           ; Store decayed peak, clear ACC
-
-; 2. Update LAVG: LAVG = max(AVG, decayed_peak)
-rdax ${reg.AVG}, 1.0
-maxx ${reg.TEMP}, 1.0
-wrax ${reg.LAVG}, 0.0           ; Update LAVG with the maximum of current and decayed
-
-; --- Output Routing ---
-@if pinConnected(single)
-rdax ${reg.AVG}, 1.0
-wrax ${output.single}, 0.0
-@endif
-
-@if pinConnected(dual)
-rdax ${reg.LAVG}, 1.0
-wrax ${output.dual}, 0.0
-@endif
-
+---
+{
+  "type": "control.envelope",
+  "category": "Control",
+  "name": "Envelope Follower",
+  "description": "Multi-mode envelope follower based on the SpinCAD 'Envelope' block algorithm. Outputs both a Single Slope (average) and a Dual Slope (peak with decay) follower.",
+  "labelTemplate": "",
+  "color": "#f2b824",
+  "inputs": [
+    {
+      "id": "audio",
+      "name": "Audio Input",
+      "type": "audio",
+      "required": true
+    },
+    {
+      "id": "sens",
+      "name": "Sensitivity",
+      "type": "control",
+      "required": false,
+      "parameter": "gain"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "single",
+      "name": "Single Slope",
+      "type": "control"
+    },
+    {
+      "id": "dual",
+      "name": "Dual Slope",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "gain",
+      "name": "Sensitivity",
+      "type": "number",
+      "default": 1.5,
+      "min": 0.5,
+      "max": 1.99,
+      "step": 0.01,
+      "description": "Pre-detection boost (up to ~4x with internal SOF stage). Higher values make the envelope respond to quieter signals."
+    },
+    {
+      "id": "attack",
+      "name": "Attack Rate",
+      "type": "number",
+      "default": 0.78,
+      "min": 0.1,
+      "max": 20.0,
+      "step": 0.01,
+      "conversion": "LOGFREQ",
+      "description": "Corner frequency for the Single Slope (average) follower. 0.78 Hz ≈ 0.00015 coefficient."
+    },
+    {
+      "id": "decay",
+      "name": "Decay Rate",
+      "type": "number",
+      "default": 0.52,
+      "min": 0.1,
+      "max": 10.0,
+      "step": 0.01,
+      "conversion": "LOGFREQ",
+      "description": "Release frequency for the Dual Slope (peak) follower. 0.52 Hz ≈ 0.0001 coefficient."
+    }
+  ],
+  "registers": [
+    "AVG",
+    "LAVG",
+    "TEMP"
+  ]
+}
+---
+; Envelope Follower
+; Based on EnvelopeControlCADBlock.java
+
+@section main
+@if pinConnected(audio)
+
+; --- Pre-Detection Boost ---
+; RDAX coefficient (up to 1.99x) + fixed SOF 2x stage = up to ~4x total headroom boost.
+rdax ${input.audio}, ${param.gain}  ; Boost via RDAX coefficient (0.5–1.99x)
+sof 1.99, 0.0                       ; Additional 2x → env covers the full 0–1 range for normal playing levels
+absa                                 ; Full-wave rectify
+@if pinConnected(sens)
+mulx ${input.sens}                   ; Pot scales overall sensitivity (0 = off, 1.0 = full)
+@endif
+
+; --- Single Slope (Average Follower) ---
+; Computes a running average of the magnitude using a first-order low-pass filter.
+rdfx ${reg.AVG}, ${param.attack}
+wrax ${reg.AVG}, 0.0            ; Clear ACC to process Dual Slope next
+
+; --- Dual Slope (Peak Follower) ---
+; Follows the peak of the average signal with an exponential decay.
+; 1. Compute decayed peak: TEMP = LAVG * (1 - decay)
+rdax ${reg.LAVG}, 1.0
+sof -${param.decay}, 0.0        ; Apply coefficient as multiplier (-decay)
+rdax ${reg.LAVG}, 1.0           ; ACC = LAVG - decay*LAVG
+wrax ${reg.TEMP}, 0.0           ; Store decayed peak, clear ACC
+
+; 2. Update LAVG: LAVG = max(AVG, decayed_peak)
+rdax ${reg.AVG}, 1.0
+maxx ${reg.TEMP}, 1.0
+wrax ${reg.LAVG}, 0.0           ; Update LAVG with the maximum of current and decayed
+
+; --- Output Routing ---
+@if pinConnected(single)
+rdax ${reg.AVG}, 1.0
+wrax ${output.single}, 0.0
+@endif
+
+@if pinConnected(dual)
+rdax ${reg.LAVG}, 1.0
+wrax ${output.dual}, 0.0
+@endif
+
 @endif

package/blocks/control/invert.atl

@@ -1,33 +1,33 @@
----
-{
-  "type": "control.invert",
-  "name": "Invert",
-  "category": "Control",
-  "description": "Inverts a control signal: 0.0→1.0, 1.0→0.0.",
-  "color": "#f2b824",
-  "width": 140,
-  "inputs": [
-    {
-      "id": "input",
-      "name": "Input",
-      "type": "control"
-    }
-  ],
-  "outputs": [
-    {
-      "id": "output",
-      "name": "Output",
-      "type": "control"
-    }
-  ],
-  "parameters": []
-}
----
-; Control Invert
-@section main
-
-@if pinConnected(input)
-rdax ${input.input}, 1.0
-sof -0.999, 0.999
-wrax ${output.output}, 0.0
-@endif
+---
+{
+  "type": "control.invert",
+  "name": "Invert",
+  "category": "Control",
+  "description": "Inverts a control signal: 0.0→1.0, 1.0→0.0.",
+  "color": "#f2b824",
+  "width": 140,
+  "inputs": [
+    {
+      "id": "input",
+      "name": "Input",
+      "type": "control"
+    }
+  ],
+  "outputs": [
+    {
+      "id": "output",
+      "name": "Output",
+      "type": "control"
+    }
+  ],
+  "parameters": []
+}
+---
+; Control Invert
+@section main
+
+@if pinConnected(input)
+rdax ${input.input}, 1.0
+sof -0.999, 0.999
+wrax ${output.output}, 0.0
+@endif

package/blocks/control/pot.atl

@@ -1,150 +1,150 @@
----
-{
-  "type": "input.pot",
-  "name": "Potentiometer",
-  "category": "Control",
-  "description": "Reads a hardware potentiometer value with optional filtering (Smoothing or Speedup) and inversion.",
-  "color": "#4CAF50",
-  "width": 150,
-  "labelTemplate": "POT ${param.potNumber}",
-  "inputs": [],
-  "outputs": [
-    {
-      "id": "out",
-      "name": "Control",
-      "type": "control"
-    }
-  ],
-  "parameters": [
-    {
-      "id": "potNumber",
-      "name": "Pot Number",
-      "type": "select",
-      "default": 0,
-      "options": [
-        {
-          "label": "POT0",
-          "value": 0
-        },
-        {
-          "label": "POT1",
-          "value": 1
-        },
-        {
-          "label": "POT2",
-          "value": 2
-        }
-      ]
-    },
-    {
-      "id": "lpCoeff",
-      "name": "LP Coefficient",
-      "type": "number",
-      "default": 0.001,
-      "min": 0.001,
-      "max": 0.1,
-      "step": 0.001,
-      "displayDecimals": 3,
-      "visibleIf": "speedup == true"
-    },
-    {
-      "id": "hpCoeff",
-      "name": "Speedup Amount",
-      "type": "number",
-      "default": -0.75,
-      "min": -0.99,
-      "max": 0,
-      "step": 0.01,
-      "visibleIf": "speedup == true",
-      "description": "Negative values provide lead (faster response)"
-    },
-    {
-      "id": "invert",
-      "name": "Invert",
-      "type": "boolean",
-      "default": false,
-      "description": "Inverts the output value"
-    },
-    {
-      "id": "speedup",
-      "name": "Speedup",
-      "type": "boolean",
-      "default": false,
-      "description": "Speeds up the response of the pot"
-    },
-    {
-      "id": "ignoreIfZero",
-      "name": "Ignore if Zero (Fallback to Default)",
-      "type": "boolean",
-      "default": false,
-      "description": "If true, blocks connected to this pot will use their default value when the pot is turned down."
-    },
-    {
-      "id": "zeroValue",
-      "name": "Zero Bypass Value",
-      "type": "number",
-      "default": 0.0,
-      "min": 0.0,
-      "max": 1.0,
-      "step": 0.01,
-      "description": "The value sent to connected @cv inputs when the pot is turned all the way down (zero-bypass active).",
-      "visibleIf": "ignoreIfZero == true"
-    },
-    {
-      "id": "custom_range",
-      "name": "Custom Scaling",
-      "type": "boolean",
-      "default": false,
-      "description": "Custom scaling for the pot"
-    },
-    {
-      "id": "pot_min",
-      "name": "Min",
-      "type": "number",
-      "default": 0.0,
-      "min": 0.0,
-      "max": 1.0,
-      "step": 0.01,
-      "visibleIf": "custom_range == true"
-    },
-    {
-      "id": "pot_max",
-      "name": "Max",
-      "type": "number",
-      "default": 1.0,
-      "min": 0.0,
-      "max": 1.0,
-      "step": 0.01,
-      "visibleIf": "custom_range == true"
-    }
-  ],
-  "registers": [
-    "f1",
-    "f2"
-  ]
-}
----
-@section input
-
-@acc = POT${param.potNumber}
-@if ${param.speedup} == true
-  ; Speedup filter (lead-lag) for fast response with some smoothing
-  RDFX ${reg.f1}, ${param.lpCoeff}
-  WRHX ${reg.f1}, ${param.hpCoeff}
-  @multiplyDouble negHpCoeff -1.0 ${param.hpCoeff}
-  RDAX ${reg.f2}, ${negHpCoeff}
-  WRAX ${reg.f2}, 1.0
-@endif
-
-@if ${param.invert} == true
-@acc = @acc * -1.0 + 1.0 ; Invert
-@endif
-
-@if ${param.custom_range} == true
-  @if ${param.pot_min} != 0.0 || ${param.pot_max} != 1.0
-    @assert ${param.pot_max} > ${param.pot_min}, "Custom POT scaling: max must be greater than min"
-    @acc = @acc * (${param.pot_max} - ${param.pot_min}) + ${param.pot_min} ; Custom scaling
-  @endif
-@endif
-
+---
+{
+  "type": "input.pot",
+  "name": "Potentiometer",
+  "category": "Control",
+  "description": "Reads a hardware potentiometer value with optional filtering (Smoothing or Speedup) and inversion.",
+  "color": "#4CAF50",
+  "width": 150,
+  "labelTemplate": "POT ${param.potNumber}",
+  "inputs": [],
+  "outputs": [
+    {
+      "id": "out",
+      "name": "Control",
+      "type": "control"
+    }
+  ],
+  "parameters": [
+    {
+      "id": "potNumber",
+      "name": "Pot Number",
+      "type": "select",
+      "default": 0,
+      "options": [
+        {
+          "label": "POT0",
+          "value": 0
+        },
+        {
+          "label": "POT1",
+          "value": 1
+        },
+        {
+          "label": "POT2",
+          "value": 2
+        }
+      ]
+    },
+    {
+      "id": "lpCoeff",
+      "name": "LP Coefficient",
+      "type": "number",
+      "default": 0.001,
+      "min": 0.001,
+      "max": 0.1,
+      "step": 0.001,
+      "displayDecimals": 3,
+      "visibleIf": "speedup == true"
+    },
+    {
+      "id": "hpCoeff",
+      "name": "Speedup Amount",
+      "type": "number",
+      "default": -0.75,
+      "min": -0.99,
+      "max": 0,
+      "step": 0.01,
+      "visibleIf": "speedup == true",
+      "description": "Negative values provide lead (faster response)"
+    },
+    {
+      "id": "invert",
+      "name": "Invert",
+      "type": "boolean",
+      "default": false,
+      "description": "Inverts the output value"
+    },
+    {
+      "id": "speedup",
+      "name": "Speedup",
+      "type": "boolean",
+      "default": false,
+      "description": "Speeds up the response of the pot"
+    },
+    {
+      "id": "ignoreIfZero",
+      "name": "Ignore if Zero (Fallback to Default)",
+      "type": "boolean",
+      "default": false,
+      "description": "If true, blocks connected to this pot will use their default value when the pot is turned down."
+    },
+    {
+      "id": "zeroValue",
+      "name": "Zero Bypass Value",
+      "type": "number",
+      "default": 0.0,
+      "min": 0.0,
+      "max": 1.0,
+      "step": 0.01,
+      "description": "The value sent to connected @cv inputs when the pot is turned all the way down (zero-bypass active).",
+      "visibleIf": "ignoreIfZero == true"
+    },
+    {
+      "id": "custom_range",
+      "name": "Custom Scaling",
+      "type": "boolean",
+      "default": false,
+      "description": "Custom scaling for the pot"
+    },
+    {
+      "id": "pot_min",
+      "name": "Min",
+      "type": "number",
+      "default": 0.0,
+      "min": 0.0,
+      "max": 1.0,
+      "step": 0.01,
+      "visibleIf": "custom_range == true"
+    },
+    {
+      "id": "pot_max",
+      "name": "Max",
+      "type": "number",
+      "default": 1.0,
+      "min": 0.0,
+      "max": 1.0,
+      "step": 0.01,
+      "visibleIf": "custom_range == true"
+    }
+  ],
+  "registers": [
+    "f1",
+    "f2"
+  ]
+}
+---
+@section input
+
+@acc = POT${param.potNumber}
+@if ${param.speedup} == true
+  ; Speedup filter (lead-lag) for fast response with some smoothing
+  RDFX ${reg.f1}, ${param.lpCoeff}
+  WRHX ${reg.f1}, ${param.hpCoeff}
+  @multiplyDouble negHpCoeff -1.0 ${param.hpCoeff}
+  RDAX ${reg.f2}, ${negHpCoeff}
+  WRAX ${reg.f2}, 1.0
+@endif
+
+@if ${param.invert} == true
+@acc = @acc * -1.0 + 1.0 ; Invert
+@endif
+
+@if ${param.custom_range} == true
+  @if ${param.pot_min} != 0.0 || ${param.pot_max} != 1.0
+    @assert ${param.pot_max} > ${param.pot_min}, "Custom POT scaling: max must be greater than min"
+    @acc = @acc * (${param.pot_max} - ${param.pot_min}) + ${param.pot_min} ; Custom scaling
+  @endif
+@endif
+
 ${output.out} = @acc