@vessel-dsp/core 0.6.3 → 0.6.5

package/dist/panel/extract.js

@@ -1,13 +1,48 @@
-import { isParsedQuantity, propertyNumericValue, propertyStringValue } from '../model/properties.js';
-import { buildKnobSteps, snapKnobPosition } from './knobs.js';
+import { isParsedQuantity, propertyNumericValue, propertyStringValue, } from "../model/properties.js";
+import { buildKnobSteps, snapKnobPosition } from "./knobs.js";
 const RUNTIME_CONTINUOUS_CONTROL_SPECS = [
-    { key: 'time', controlProperty: 'TimeControl', wipeProperty: 'TimeControlWipe', sweepProperty: 'TimeControlSweep' },
-    { key: 'feedback', controlProperty: 'FeedbackControl', wipeProperty: 'FeedbackControlWipe', sweepProperty: 'FeedbackControlSweep' },
-    { key: 'mix', controlProperty: 'MixControl', wipeProperty: 'MixControlWipe', sweepProperty: 'MixControlSweep' },
-    { key: 'level', controlProperty: 'LevelControl', wipeProperty: 'LevelControlWipe', sweepProperty: 'LevelControlSweep' },
-    { key: 'tone', controlProperty: 'ToneControl', wipeProperty: 'ToneControlWipe', sweepProperty: 'ToneControlSweep' },
-    { key: 'mod-rate', controlProperty: 'ModRateControl', wipeProperty: 'ModRateControlWipe', sweepProperty: 'ModRateControlSweep' },
-    { key: 'mod-depth', controlProperty: 'ModDepthControl', wipeProperty: 'ModDepthControlWipe', sweepProperty: 'ModDepthControlSweep' },
+    {
+        key: "time",
+        controlProperty: "TimeControl",
+        wipeProperty: "TimeControlWipe",
+        sweepProperty: "TimeControlSweep",
+    },
+    {
+        key: "feedback",
+        controlProperty: "FeedbackControl",
+        wipeProperty: "FeedbackControlWipe",
+        sweepProperty: "FeedbackControlSweep",
+    },
+    {
+        key: "mix",
+        controlProperty: "MixControl",
+        wipeProperty: "MixControlWipe",
+        sweepProperty: "MixControlSweep",
+    },
+    {
+        key: "level",
+        controlProperty: "LevelControl",
+        wipeProperty: "LevelControlWipe",
+        sweepProperty: "LevelControlSweep",
+    },
+    {
+        key: "tone",
+        controlProperty: "ToneControl",
+        wipeProperty: "ToneControlWipe",
+        sweepProperty: "ToneControlSweep",
+    },
+    {
+        key: "mod-rate",
+        controlProperty: "ModRateControl",
+        wipeProperty: "ModRateControlWipe",
+        sweepProperty: "ModRateControlSweep",
+    },
+    {
+        key: "mod-depth",
+        controlProperty: "ModDepthControl",
+        wipeProperty: "ModDepthControlWipe",
+        sweepProperty: "ModDepthControlSweep",
+    },
 ];
 // extractPanel inspects a CircuitDocument and emits the typed Panel descriptor
 // that drives the runtime control surface. It's a pure read over the existing
@@ -20,7 +55,19 @@ export function extractPanel(doc) {
     const jacks = [];
     for (const component of doc.components) {
         switch (component.kind) {
-            case 'potentiometer': {
+            case "variable-resistor": {
+                if (!isVariableResistorControl(component)) {
+                    break;
+                }
+                if (isSliderControl(component)) {
+                    sliders.push(toSlider(component));
+                }
+                else {
+                    knobs.push(toKnob(component));
+                }
+                break;
+            }
+            case "potentiometer": {
                 if (isSliderControl(component)) {
                     sliders.push(toSlider(component));
                 }
@@ -29,15 +76,15 @@ export function extractPanel(doc) {
                 }
                 break;
             }
-            case 'switch': {
+            case "switch": {
                 switches.push(toSwitch(component));
                 break;
             }
-            case 'led': {
+            case "led": {
                 leds.push(toLed(component));
                 break;
             }
-            case 'jack': {
+            case "jack": {
                 jacks.push(toJack(component));
                 break;
             }
@@ -74,7 +121,7 @@ export function extractDeviceInterface(doc) {
     for (const control of doc.deviceInterface?.controls ?? []) {
         controls.set(control.id, {
             ...control,
-            provenance: 'vdsp-declared',
+            provenance: "vdsp-declared",
         });
     }
     for (const inferred of inferredControls) {
@@ -90,24 +137,73 @@ export function extractDeviceInterface(doc) {
             });
             continue;
         }
-        if (declared.binding !== undefined
-            && inferred.binding !== undefined
-            && bindingSignature(declared.binding) !== bindingSignature(inferred.binding)) {
+        if (declared.binding !== undefined &&
+            inferred.binding !== undefined &&
+            bindingSignature(declared.binding) !== bindingSignature(inferred.binding)) {
             diagnostics.push({
-                code: 'device-interface-inferred-binding-conflict',
+                code: "device-interface-inferred-binding-conflict",
                 message: `Declared device interface control "${declared.id}" conflicts with inferred binding`,
                 componentId: declared.id,
             });
         }
     }
+    const resolvedControls = Array.from(controls.values());
     return {
         groups: doc.controlGroups ?? [],
         contexts: doc.controlContexts ?? [],
-        controls: Array.from(controls.values()),
+        controls: resolvedControls,
+        groupMemberships: resolveControlGroupMemberships(doc.controlGroups ?? [], controls),
         ...(panel.placement === undefined ? {} : { placement: panel.placement }),
         diagnostics,
     };
 }
+function resolveControlGroupMemberships(groups, controls) {
+    const memberships = [];
+    const groupsById = new Map(groups.map((group) => [group.id, group]));
+    const explicitMemberships = new Set();
+    for (const group of groups) {
+        for (const member of group.members ?? []) {
+            const control = controls.get(member.controlId);
+            if (control === undefined) {
+                continue;
+            }
+            explicitMemberships.add(`${group.id}:${control.id}`);
+            memberships.push({
+                group,
+                control,
+                ...(member.order === undefined ? {} : { order: member.order }),
+                ...(member.appliesWhen === undefined
+                    ? {}
+                    : { appliesWhen: member.appliesWhen }),
+                ...(member.description === undefined
+                    ? {}
+                    : { description: member.description }),
+            });
+        }
+    }
+    for (const control of controls.values()) {
+        if (control.groupId === undefined) {
+            continue;
+        }
+        const group = groupsById.get(control.groupId);
+        if (group === undefined ||
+            explicitMemberships.has(`${group.id}:${control.id}`)) {
+            continue;
+        }
+        memberships.push({
+            group,
+            control,
+            ...(control.order === undefined ? {} : { order: control.order }),
+            ...(control.appliesWhen === undefined
+                ? {}
+                : { appliesWhen: control.appliesWhen }),
+            ...(control.description === undefined
+                ? {}
+                : { description: control.description }),
+        });
+    }
+    return memberships;
+}
 function inferDeviceInterfaceControls(doc, panel) {
     const controls = [];
     const controlInterfaceIds = new Set();
@@ -123,7 +219,7 @@ function inferDeviceInterfaceControls(doc, panel) {
         controls.push({
             id: knob.id,
             label: knob.name,
-            kind: 'knob',
+            kind: "knob",
             role: roleFromControlId(knob.id),
             binding: {
                 componentId,
@@ -138,21 +234,21 @@ function inferDeviceInterfaceControls(doc, panel) {
         controls.push({
             id: slider.id,
             label: slider.name,
-            kind: 'slider',
+            kind: "slider",
             role: roleFromControlId(slider.id),
             binding: {
                 componentId: componentIdFromControlId(slider.id),
                 controlId: slider.id,
                 controlName: slider.name,
             },
-            provenance: 'source-inferred',
+            provenance: "source-inferred",
         });
     }
     for (const switchControl of panel.switches) {
         controls.push({
             id: switchControl.id,
             label: switchControl.name,
-            kind: 'switch',
+            kind: "switch",
             role: roleFromControlId(switchControl.id),
             binding: {
                 componentId: componentIdFromControlId(switchControl.id),
@@ -166,14 +262,14 @@ function inferDeviceInterfaceControls(doc, panel) {
         controls.push({
             id: led.id,
             label: led.name,
-            kind: 'led',
-            role: 'indicator',
+            kind: "led",
+            role: "indicator",
             binding: {
                 componentId: componentIdFromControlId(led.id),
                 controlId: led.id,
                 controlName: led.name,
             },
-            provenance: 'source-inferred',
+            provenance: "source-inferred",
         });
     }
     for (const jack of panel.jacks) {
@@ -182,11 +278,11 @@ function inferDeviceInterfaceControls(doc, panel) {
         controls.push({
             id: jack.id,
             label: jack.name,
-            kind: 'jack',
+            kind: "jack",
             role: jack.controlRole ?? jack.role,
             ...(binding === undefined ? {} : { binding }),
             provenance: controlInterfaceIds.has(jack.id)
-                ? 'control-interface-declared'
+                ? "control-interface-declared"
                 : provenanceForComponentControl(doc, componentId),
         });
     }
@@ -196,12 +292,12 @@ function deviceBindingForJack(jack, componentId) {
     if (jack.binding !== undefined) {
         return deviceBindingFromControlInterfaceBinding(jack.binding, componentId);
     }
-    if (jack.id.endsWith(':tempo-tap')) {
+    if (jack.id.endsWith(":tempo-tap")) {
         return {
             componentId,
             controlId: jack.id,
             controlName: jack.name,
-            property: 'TempoTapControl',
+            property: "TempoTapControl",
         };
     }
     if (jack.sourceComponentId !== undefined || jack.id === componentId) {
@@ -220,23 +316,27 @@ function deviceBindingFromControlInterfaceBinding(binding, fallbackComponentId)
     const componentId = binding.sourceComponentId ?? fallbackComponentId;
     return {
         componentId,
-        ...(binding.controlId === undefined ? {} : { controlId: binding.controlId }),
-        ...(binding.controlName === undefined ? {} : { controlName: binding.controlName }),
+        ...(binding.controlId === undefined
+            ? {}
+            : { controlId: binding.controlId }),
+        ...(binding.controlName === undefined
+            ? {}
+            : { controlName: binding.controlName }),
         ...(binding.property === undefined ? {} : { property: binding.property }),
     };
 }
 function provenanceForComponentControl(doc, componentId) {
     const component = doc.components.find((candidate) => candidate.id === componentId);
     return component !== undefined && isRuntimeDescriptor(component)
-        ? 'runtime-descriptor-inferred'
-        : 'source-inferred';
+        ? "runtime-descriptor-inferred"
+        : "source-inferred";
 }
 function componentIdFromControlId(id) {
-    const separator = id.indexOf(':');
+    const separator = id.indexOf(":");
     return separator <= 0 ? id : id.slice(0, separator);
 }
 function roleFromControlId(id) {
-    const separator = id.indexOf(':');
+    const separator = id.indexOf(":");
     const raw = separator >= 0 ? id.slice(separator + 1) : id;
     return normalizeToken(raw);
 }
@@ -247,25 +347,25 @@ function runtimeControlProperty(id) {
             return spec.controlProperty;
         }
     }
-    if (key === 'mode') {
-        return 'ModeControl';
+    if (key === "mode") {
+        return "ModeControl";
     }
-    if (key === 'tempo-tap') {
-        return 'TempoTapControl';
+    if (key === "tempo-tap") {
+        return "TempoTapControl";
     }
-    if (key === 'direct-out') {
-        return 'DirectOutputJack';
+    if (key === "direct-out") {
+        return "DirectOutputJack";
     }
     return undefined;
 }
 function bindingSignature(binding) {
     return [
         binding.componentId,
-        binding.controlId ?? '',
-        binding.controlName ?? '',
-        binding.property ?? '',
-        binding.externalInterfaceId ?? '',
-    ].join(':');
+        binding.controlId ?? "",
+        binding.controlName ?? "",
+        binding.property ?? "",
+        binding.externalInterfaceId ?? "",
+    ].join(":");
 }
 function applyControlInterfaces(controlInterfaces, jacks) {
     for (const controlInterface of controlInterfaces ?? []) {
@@ -295,70 +395,90 @@ function toControlInterfaceJack(controlInterface) {
         ...(sourceComponentId === undefined ? {} : { sourceComponentId }),
         ...(controlRole === undefined ? {} : { controlRole }),
         ...(interfaceName === undefined ? {} : { interface: interfaceName }),
-        ...(controlInterface.connector === undefined ? {} : { connector: controlInterface.connector }),
-        ...(controlInterface.assignmentHint === undefined ? {} : { assignmentHint: controlInterface.assignmentHint }),
-        ...(controlInterface.polarity === undefined ? {} : { polarity: controlInterface.polarity }),
-        ...(controlInterface.binding === undefined ? {} : { binding: controlInterface.binding }),
-        ...(controlInterface.description === undefined ? {} : { description: controlInterface.description }),
+        ...(controlInterface.connector === undefined
+            ? {}
+            : { connector: controlInterface.connector }),
+        ...(controlInterface.assignmentHint === undefined
+            ? {}
+            : { assignmentHint: controlInterface.assignmentHint }),
+        ...(controlInterface.polarity === undefined
+            ? {}
+            : { polarity: controlInterface.polarity }),
+        ...(controlInterface.binding === undefined
+            ? {}
+            : { binding: controlInterface.binding }),
+        ...(controlInterface.description === undefined
+            ? {}
+            : { description: controlInterface.description }),
     };
 }
 function jackRoleForControlInterface(controlInterface) {
     switch (controlInterface.role) {
-        case 'tempo-tap':
-            return 'tempo-tap';
-        case 'expression':
-            return 'expression';
-        case 'external-control':
-        case 'trigger':
-        case 'reset':
-        case 'sampler-trigger':
-            return 'external-control';
-        case 'unknown':
-            return 'unknown';
+        case "tempo-tap":
+            return "tempo-tap";
+        case "expression":
+            return "expression";
+        case "external-control":
+        case "trigger":
+        case "reset":
+        case "sampler-trigger":
+            return "external-control";
+        case "unknown":
+            return "unknown";
     }
 }
 function defaultControlRole(controlInterface) {
-    return controlInterface.role === 'unknown' || controlInterface.role === 'external-control'
+    return controlInterface.role === "unknown" ||
+        controlInterface.role === "external-control"
         ? undefined
         : controlInterface.role;
 }
 function defaultInterfaceName(controlInterface) {
-    if (controlInterface.role === 'tempo-tap') {
-        return 'tap-tempo';
+    if (controlInterface.role === "tempo-tap") {
+        return "tap-tempo";
     }
-    if (controlInterface.role === 'unknown') {
+    if (controlInterface.role === "unknown") {
         return undefined;
     }
-    return 'external-control-input';
+    return "external-control-input";
 }
 function toKnob(component) {
-    const taper = resolveTaper(propertyString(component, 'Sweep') ?? propertyString(component, 'Taper'));
-    const stepLabels = parseStepLabels(propertyStringAny(component, ['StepLabels', 'Steps']));
-    const explicitStepCount = parseStepCount(propertyStringAny(component, ['StepCount', 'Detents', 'Positions', 'Steps']));
-    const steps = buildKnobSteps(stepLabels.length >= 2 ? stepLabels.length : explicitStepCount ?? 0, stepLabels);
+    const taper = resolveTaper(propertyString(component, "Sweep") ?? propertyString(component, "Taper"));
+    const stepLabels = parseStepLabels(propertyStringAny(component, ["StepLabels", "Steps"]));
+    const explicitStepCount = parseStepCount(propertyStringAny(component, [
+        "StepCount",
+        "Detents",
+        "Positions",
+        "Steps",
+    ]));
+    const steps = buildKnobSteps(stepLabels.length >= 2 ? stepLabels.length : (explicitStepCount ?? 0), stepLabels);
     const rawDefaultPosition = clamp01(parseNumeric(component.properties.Wipe) ?? 0.5);
-    const defaultPosition = steps === undefined ? rawDefaultPosition : snapKnobPosition({ steps }, rawDefaultPosition);
-    const resistance = quantityProperty(component, 'Resistance');
-    const gangGroup = propertyString(component, 'Group') ?? undefined;
-    const description = propertyString(component, 'Description') ?? undefined;
+    const defaultPosition = steps === undefined
+        ? rawDefaultPosition
+        : snapKnobPosition({ steps }, rawDefaultPosition);
+    const resistance = quantityProperty(component, "Resistance");
+    const gangGroup = propertyString(component, "Group") ?? undefined;
+    const description = propertyString(component, "Description") ?? undefined;
     return {
         id: component.id,
         name: component.name,
         taper,
-        controlMode: steps === undefined ? 'continuous' : 'stepped',
+        controlMode: steps === undefined ? "continuous" : "stepped",
         defaultPosition,
         ...(steps !== undefined ? { steps } : {}),
         ...(resistance !== undefined ? { resistance } : {}),
         ...(gangGroup !== undefined && gangGroup.length > 0 ? { gangGroup } : {}),
-        ...(description !== undefined && description.length > 0 ? { description } : {}),
+        ...(description !== undefined && description.length > 0
+            ? { description }
+            : {}),
     };
 }
 function toSlider(component) {
     const defaultPosition = clamp01(parseNumeric(component.properties.Wipe) ?? 0.5);
-    const orientation = resolveSliderOrientation(propertyStringAny(component, ['Orientation', 'SliderOrientation']));
+    const orientation = resolveSliderOrientation(propertyStringAny(component, ["Orientation", "SliderOrientation"]));
     const range = sliderRange(component);
-    const gangGroup = propertyString(component, 'Group') ?? undefined;
-    const description = propertyString(component, 'Description') ?? undefined;
+    const gangGroup = propertyString(component, "Group") ?? undefined;
+    const description = propertyString(component, "Description") ?? undefined;
     return {
         id: component.id,
         name: component.name,
@@ -366,16 +486,18 @@ function toSlider(component) {
         orientation,
         ...(range !== undefined ? { range } : {}),
         ...(gangGroup !== undefined && gangGroup.length > 0 ? { gangGroup } : {}),
-        ...(description !== undefined && description.length > 0 ? { description } : {}),
+        ...(description !== undefined && description.length > 0
+            ? { description }
+            : {}),
     };
 }
 function toSwitch(component) {
     const switchKind = resolveSwitchKind(component);
     const { poles, positions } = switchGeometry(switchKind);
     const defaultPosition = clampInt(parseNumeric(component.properties.Position) ?? 0, 0, positions - 1);
-    const gangGroup = propertyString(component, 'Group') ?? undefined;
-    const partNumber = propertyString(component, 'PartNumber') ?? undefined;
-    const description = propertyString(component, 'Description') ?? undefined;
+    const gangGroup = propertyString(component, "Group") ?? undefined;
+    const partNumber = propertyString(component, "PartNumber") ?? undefined;
+    const description = propertyString(component, "Description") ?? undefined;
     return {
         id: component.id,
         name: component.name,
@@ -384,30 +506,39 @@ function toSwitch(component) {
         positions,
         defaultPosition,
         ...(gangGroup !== undefined && gangGroup.length > 0 ? { gangGroup } : {}),
-        ...(partNumber !== undefined && partNumber.length > 0 ? { partNumber } : {}),
-        ...(description !== undefined && description.length > 0 ? { description } : {}),
+        ...(partNumber !== undefined && partNumber.length > 0
+            ? { partNumber }
+            : {}),
+        ...(description !== undefined && description.length > 0
+            ? { description }
+            : {}),
     };
 }
 function toLed(component) {
-    const color = propertyString(component, 'Color') ?? inferLedColor(component);
-    const partNumber = propertyString(component, 'PartNumber') ?? undefined;
-    const description = propertyString(component, 'Description') ?? undefined;
+    const color = propertyString(component, "Color") ?? inferLedColor(component);
+    const partNumber = propertyString(component, "PartNumber") ?? undefined;
+    const description = propertyString(component, "Description") ?? undefined;
     return {
         id: component.id,
         name: component.name,
         ...(color !== undefined ? { color } : {}),
-        ...(partNumber !== undefined && partNumber.length > 0 ? { partNumber } : {}),
-        ...(description !== undefined && description.length > 0 ? { description } : {}),
+        ...(partNumber !== undefined && partNumber.length > 0
+            ? { partNumber }
+            : {}),
+        ...(description !== undefined && description.length > 0
+            ? { description }
+            : {}),
     };
 }
 function toJack(component) {
     const role = resolveJackRole(component);
-    const name = nonEmptyString(propertyStringAny(component, ['JackLabel', 'Label'])) ?? component.name;
-    const audioRole = nonEmptyString(propertyString(component, 'AudioRole'));
-    const impedance = quantityProperty(component, 'Impedance');
-    const controlRole = nonEmptyString(propertyString(component, 'ControlRole'));
-    const interfaceName = nonEmptyString(propertyString(component, 'Interface'));
-    const description = propertyString(component, 'Description') ?? undefined;
+    const name = nonEmptyString(propertyStringAny(component, ["JackLabel", "Label"])) ??
+        component.name;
+    const audioRole = nonEmptyString(propertyString(component, "AudioRole"));
+    const impedance = quantityProperty(component, "Impedance");
+    const controlRole = nonEmptyString(propertyString(component, "ControlRole"));
+    const interfaceName = nonEmptyString(propertyString(component, "Interface"));
+    const description = propertyString(component, "Description") ?? undefined;
     const sourceTypeName = component.sourceTypeName ?? undefined;
     return {
         id: component.id,
@@ -418,7 +549,9 @@ function toJack(component) {
         ...(sourceTypeName !== undefined ? { sourceTypeName } : {}),
         ...(controlRole !== undefined ? { controlRole } : {}),
         ...(interfaceName !== undefined ? { interface: interfaceName } : {}),
-        ...(description !== undefined && description.length > 0 ? { description } : {}),
+        ...(description !== undefined && description.length > 0
+            ? { description }
+            : {}),
     };
 }
 function runtimeDescriptorKnobs(component) {
@@ -432,7 +565,7 @@ function runtimeDescriptorKnobs(component) {
             id: `${component.id}:${spec.key}`,
             name,
             taper: resolveTaper(propertyString(component, spec.sweepProperty)),
-            controlMode: 'continuous',
+            controlMode: "continuous",
             defaultPosition: clamp01(parseNumeric(component.properties[spec.wipeProperty]) ?? 0.5),
         });
     }
@@ -443,96 +576,120 @@ function runtimeDescriptorKnobs(component) {
     return knobs;
 }
 function runtimeDescriptorMode(component) {
-    const name = nonEmptyString(propertyString(component, 'ModeControl'));
-    const labels = parseStepLabels(propertyStringAny(component, ['ModeLabels', 'ModeOptions']));
-    const explicitStepCount = parseStepCount(propertyStringAny(component, ['ModeStepCount', 'ModeSteps', 'ModeCount']));
-    const steps = buildKnobSteps(labels.length >= 2 ? labels.length : explicitStepCount ?? 0, labels);
+    const name = nonEmptyString(propertyString(component, "ModeControl"));
+    const labels = parseStepLabels(propertyStringAny(component, ["ModeLabels", "ModeOptions"]));
+    const explicitStepCount = parseStepCount(propertyStringAny(component, ["ModeStepCount", "ModeSteps", "ModeCount"]));
+    const steps = buildKnobSteps(labels.length >= 2 ? labels.length : (explicitStepCount ?? 0), labels);
     if (name === undefined || steps === undefined) {
         return undefined;
     }
     return {
         id: `${component.id}:mode`,
         name,
-        taper: 'unknown',
-        controlMode: 'stepped',
-        defaultPosition: runtimeModeDefaultPosition(steps, parseNumericAny(component, ['ModeControlWipe', 'ModeDefaultIndex', 'ModeIndex'])),
+        taper: "unknown",
+        controlMode: "stepped",
+        defaultPosition: runtimeModeDefaultPosition(steps, parseNumericAny(component, [
+            "ModeControlWipe",
+            "ModeDefaultIndex",
+            "ModeIndex",
+        ])),
         steps,
     };
 }
 function runtimeDescriptorTempoTap(component) {
-    const name = nonEmptyString(propertyStringAny(component, ['TempoTapControl', 'TapTempoControl', 'TempoControl']));
+    const name = nonEmptyString(propertyStringAny(component, [
+        "TempoTapControl",
+        "TapTempoControl",
+        "TempoControl",
+    ]));
     if (name === undefined) {
         return undefined;
     }
     const sourceTypeName = component.sourceTypeName ?? undefined;
-    const assignmentHint = 'momentary';
+    const assignmentHint = "momentary";
     return {
         id: `${component.id}:tempo-tap`,
         name,
-        role: 'tempo-tap',
+        role: "tempo-tap",
         sourceComponentId: component.id,
-        controlRole: 'tempo-tap',
-        interface: 'tap-tempo',
+        controlRole: "tempo-tap",
+        interface: "tap-tempo",
         assignmentHint,
         ...(sourceTypeName !== undefined ? { sourceTypeName } : {}),
     };
 }
 function runtimeDescriptorDirectOut(component) {
     const name = nonEmptyString(propertyStringAny(component, [
-        'DirectOutputJack',
-        'DirectOutJack',
-        'DirectOutputControl',
-        'DirectOutControl',
+        "DirectOutputJack",
+        "DirectOutJack",
+        "DirectOutputControl",
+        "DirectOutControl",
     ]));
     if (name === undefined) {
         return undefined;
     }
     const sourceTypeName = component.sourceTypeName ?? undefined;
     const description = nonEmptyString(propertyStringAny(component, [
-        'DirectOutputRuntimeBoundary',
-        'DirectOutputDescription',
-        'DirectOutDescription',
+        "DirectOutputRuntimeBoundary",
+        "DirectOutputDescription",
+        "DirectOutDescription",
     ]));
     const controlId = `${component.id}:direct-out`;
     return {
         id: controlId,
         name,
-        role: 'direct-output',
+        role: "direct-output",
         sourceComponentId: component.id,
-        controlRole: 'direct-output',
-        interface: 'audio-output',
+        controlRole: "direct-output",
+        interface: "audio-output",
         binding: {
             sourceComponentId: component.id,
             controlId,
             controlName: name,
-            property: 'DirectOutputJack',
+            property: "DirectOutputJack",
         },
         ...(sourceTypeName !== undefined ? { sourceTypeName } : {}),
         ...(description === undefined ? {} : { description }),
     };
 }
 function isSliderControl(component) {
-    const style = propertyStringAny(component, ['ControlStyle', 'ControlType', 'PanelControl', 'UiControl', 'Style']);
+    const style = propertyStringAny(component, [
+        "ControlStyle",
+        "ControlType",
+        "PanelControl",
+        "UiControl",
+        "Style",
+    ]);
     if (style === null) {
         return false;
     }
     const lower = style.toLowerCase();
-    return lower.includes('slider') || lower.includes('fader');
+    return lower.includes("slider") || lower.includes("fader");
+}
+function isVariableResistorControl(component) {
+    return (component.properties.Wipe !== undefined ||
+        component.properties.Sweep !== undefined ||
+        component.properties.Taper !== undefined ||
+        isSliderControl(component));
 }
 function resolveSliderOrientation(value) {
-    if (value?.toLowerCase().includes('horizontal')) {
-        return 'horizontal';
+    if (value?.toLowerCase().includes("horizontal")) {
+        return "horizontal";
     }
-    return 'vertical';
+    return "vertical";
 }
 function sliderRange(component) {
-    const min = parseNumericAny(component, ['RangeMin', 'Min', 'Minimum']);
-    const max = parseNumericAny(component, ['RangeMax', 'Max', 'Maximum']);
+    const min = parseNumericAny(component, ["RangeMin", "Min", "Minimum"]);
+    const max = parseNumericAny(component, ["RangeMax", "Max", "Maximum"]);
     if (min === undefined || max === undefined || min >= max) {
         return undefined;
     }
-    const unit = propertyStringAny(component, ['Unit', 'RangeUnit']) ?? undefined;
-    const center = parseNumericAny(component, ['Center', 'CenterValue', 'RangeCenter']);
+    const unit = propertyStringAny(component, ["Unit", "RangeUnit"]) ?? undefined;
+    const center = parseNumericAny(component, [
+        "Center",
+        "CenterValue",
+        "RangeCenter",
+    ]);
     return {
         min,
         max,
@@ -542,19 +699,19 @@ function sliderRange(component) {
 }
 function resolveTaper(value) {
     if (value === null || value === undefined) {
-        return 'unknown';
+        return "unknown";
     }
     const lower = value.toLowerCase();
-    if (lower.includes('log') && lower.includes('rev')) {
-        return 'reverse-log';
+    if (lower.includes("log") && lower.includes("rev")) {
+        return "reverse-log";
     }
-    if (lower.includes('log') || lower.includes('audio')) {
-        return 'log';
+    if (lower.includes("log") || lower.includes("audio")) {
+        return "log";
     }
-    if (lower.includes('lin')) {
-        return 'linear';
+    if (lower.includes("lin")) {
+        return "linear";
     }
-    return 'unknown';
+    return "unknown";
 }
 function resolveSwitchKind(component) {
     const short = shortType(component.sourceTypeName);
@@ -562,47 +719,47 @@ function resolveSwitchKind(component) {
         return inferFromTerminals(component.terminals.length);
     }
     const upper = short.toUpperCase();
-    if (upper === 'SPDT')
-        return 'spdt';
-    if (upper === 'SP3T')
-        return 'sp3t';
-    if (upper === 'SP4T')
-        return 'sp4t';
-    if (upper === '3PDT')
-        return '3pdt';
-    if (upper === 'TOGGLE')
-        return 'toggle';
-    if (upper === 'ROTARY')
-        return 'rotary';
-    if (upper === 'SWITCH')
-        return 'spst';
+    if (upper === "SPDT")
+        return "spdt";
+    if (upper === "SP3T")
+        return "sp3t";
+    if (upper === "SP4T")
+        return "sp4t";
+    if (upper === "3PDT")
+        return "3pdt";
+    if (upper === "TOGGLE")
+        return "toggle";
+    if (upper === "ROTARY")
+        return "rotary";
+    if (upper === "SWITCH")
+        return "spst";
     return inferFromTerminals(component.terminals.length);
 }
 function inferFromTerminals(count) {
     if (count <= 2)
-        return 'spst';
+        return "spst";
     if (count === 3)
-        return 'spdt';
+        return "spdt";
     if (count === 9)
-        return '3pdt';
-    return 'unknown';
+        return "3pdt";
+    return "unknown";
 }
 function switchGeometry(kind) {
     switch (kind) {
-        case 'spst':
-        case 'toggle':
+        case "spst":
+        case "toggle":
             return { poles: 1, positions: 2 };
-        case 'spdt':
+        case "spdt":
             return { poles: 1, positions: 2 };
-        case 'sp3t':
+        case "sp3t":
             return { poles: 1, positions: 3 };
-        case 'sp4t':
+        case "sp4t":
             return { poles: 1, positions: 4 };
-        case '3pdt':
+        case "3pdt":
             return { poles: 3, positions: 2 };
-        case 'rotary':
+        case "rotary":
             return { poles: 1, positions: 6 };
-        case 'unknown':
+        case "unknown":
             return { poles: 1, positions: 2 };
     }
 }
@@ -613,23 +770,23 @@ function resolveJackRole(component) {
     }
     const short = shortType(component.sourceTypeName);
     if (short === null) {
-        return 'unknown';
+        return "unknown";
     }
     const upper = short.toUpperCase();
-    if (upper === 'INPUT' || upper === 'INPUTJACK')
-        return 'input';
-    if (upper === 'SPEAKER' || upper === 'OUTPUTJACK')
-        return 'output';
-    if (upper === 'SEND')
-        return 'send';
-    if (upper === 'RETURN')
-        return 'return';
-    if (upper === 'EXPRESSION' || upper === 'EXP')
-        return 'expression';
-    return 'unknown';
+    if (upper === "INPUT" || upper === "INPUTJACK")
+        return "input";
+    if (upper === "SPEAKER" || upper === "OUTPUTJACK")
+        return "output";
+    if (upper === "SEND")
+        return "send";
+    if (upper === "RETURN")
+        return "return";
+    if (upper === "EXPRESSION" || upper === "EXP")
+        return "expression";
+    return "unknown";
 }
 function resolveSemanticJackRole(component) {
-    const semanticProperties = ['Role', 'ControlRole', 'Interface'];
+    const semanticProperties = ["Role", "ControlRole", "Interface"];
     for (const name of semanticProperties) {
         const value = propertyString(component, name);
         if (value === null) {
@@ -644,48 +801,48 @@ function resolveSemanticJackRole(component) {
 }
 function normalizeJackRole(value) {
     const normalized = normalizeToken(value);
-    if (['input', 'audio-input', 'in'].includes(normalized))
-        return 'input';
-    if (['direct-output', 'direct-out', 'dry-output', 'dry-out'].includes(normalized))
-        return 'direct-output';
-    if (['output', 'audio-output', 'out'].includes(normalized))
-        return 'output';
-    if (normalized === 'send')
-        return 'send';
-    if (normalized === 'return')
-        return 'return';
-    if (['expression', 'exp', 'expression-pedal'].includes(normalized))
-        return 'expression';
-    if (['tempo-tap', 'tap-tempo', 'tempo-in', 'tap', 'tempo'].includes(normalized))
-        return 'tempo-tap';
+    if (["input", "audio-input", "in"].includes(normalized))
+        return "input";
+    if (["direct-output", "direct-out", "dry-output", "dry-out"].includes(normalized))
+        return "direct-output";
+    if (["output", "audio-output", "out"].includes(normalized))
+        return "output";
+    if (normalized === "send")
+        return "send";
+    if (normalized === "return")
+        return "return";
+    if (["expression", "exp", "expression-pedal"].includes(normalized))
+        return "expression";
+    if (["tempo-tap", "tap-tempo", "tempo-in", "tap", "tempo"].includes(normalized))
+        return "tempo-tap";
     if ([
-        'external-control',
-        'external-control-input',
-        'control-input',
-        'remote',
-        'footswitch',
-        'trigger',
-        'reset',
+        "external-control",
+        "external-control-input",
+        "control-input",
+        "remote",
+        "footswitch",
+        "trigger",
+        "reset",
     ].includes(normalized)) {
-        return 'external-control';
+        return "external-control";
     }
     return null;
 }
 function inferLedColor(component) {
     // Common pedal LED colors are usually red / amber / green. Try the part number.
-    const part = propertyString(component, 'PartNumber')?.toLowerCase() ?? '';
-    if (part.includes('red'))
-        return 'red';
-    if (part.includes('green'))
-        return 'green';
-    if (part.includes('amber'))
-        return 'amber';
-    if (part.includes('blue'))
-        return 'blue';
-    if (part.includes('yellow'))
-        return 'yellow';
-    if (part.includes('white'))
-        return 'white';
+    const part = propertyString(component, "PartNumber")?.toLowerCase() ?? "";
+    if (part.includes("red"))
+        return "red";
+    if (part.includes("green"))
+        return "green";
+    if (part.includes("amber"))
+        return "amber";
+    if (part.includes("blue"))
+        return "blue";
+    if (part.includes("yellow"))
+        return "yellow";
+    if (part.includes("white"))
+        return "white";
     return undefined;
 }
 function shortType(sourceTypeName) {
@@ -766,10 +923,13 @@ function runtimeModeDefaultPosition(steps, rawValue) {
     return snapKnobPosition({ steps }, clamp01(rawValue));
 }
 function isRuntimeDescriptor(component) {
-    return component.kind === 'ic' && component.properties.RuntimeDescriptor === 'true';
+    return (component.kind === "ic" && component.properties.RuntimeDescriptor === "true");
 }
 function normalizeToken(value) {
-    return value.trim().toLowerCase().replace(/[\s_]+/g, '-');
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, "-");
 }
 function clamp01(v) {
     if (v < 0)