@vessel-dsp/stompbox 0.6.4 → 0.6.6

package/dist/index.js

@@ -1,4 +1,3 @@
-import { readFileSync } from "node:fs";
 import { defaultControlState, extractPanel, parseCircuitDocumentFile, } from "@vessel-dsp/core";
 export function getAvailableStompboxStyleProfiles(profiles, filter) {
     return profiles.filter((profile) => profile.supportedKnobCounts.includes(filter.knobCount));
@@ -171,31 +170,8 @@ export function validateStompboxGlbAsset(bytes, partProfile, options = {}) {
         diagnostics,
     };
 }
-export function validateStompboxGlbAssetFile(path, partProfile) {
-    try {
-        return validateStompboxGlbAsset(new Uint8Array(readFileSync(path)), partProfile, {
-            assetPath: path,
-        });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const diagnostic = {
-            code: "invalid-glb-asset",
-            message: `Invalid GLB asset for stompbox part "${partProfile.id}": ${message}`,
-            partId: partProfile.id,
-            assetPath: path,
-        };
-        return {
-            schema: "stompbox-glb-asset-validation/v1",
-            partProfileId: partProfile.id,
-            assetPath: path,
-            valid: false,
-            targets: {},
-            diagnostics: [diagnostic],
-        };
-    }
-}
 export function validateStompboxHardwareProfileAssets(hardwareProfile, options = {}) {
+    const readAssetFile = requireStompboxAssetFileReader(options);
     const partIds = options.partIds ?? defaultLiveStatePartProfileIds(hardwareProfile);
     const assets = {};
     const diagnostics = [];
@@ -211,7 +187,7 @@ export function validateStompboxHardwareProfileAssets(hardwareProfile, options =
             continue;
         }
         const assetPath = resolveStompboxAssetPaths(partProfile.assets, options).glb;
-        const validation = validateStompboxGlbAssetFile(assetPath, partProfile);
+        const validation = validateStompboxGlbAssetFromPath(assetPath, partProfile, readAssetFile);
         assets[partId] = validation;
         diagnostics.push(...validation.diagnostics);
     }
@@ -222,6 +198,30 @@ export function validateStompboxHardwareProfileAssets(hardwareProfile, options =
         diagnostics,
     };
 }
+export function validateStompboxGlbAssetFromPath(path, partProfile, readAssetFile) {
+    try {
+        return validateStompboxGlbAsset(readAssetFile(path), partProfile, {
+            assetPath: path,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const diagnostic = {
+            code: "invalid-glb-asset",
+            message: `Invalid GLB asset for stompbox part "${partProfile.id}": ${message}`,
+            partId: partProfile.id,
+            assetPath: path,
+        };
+        return {
+            schema: "stompbox-glb-asset-validation/v1",
+            partProfileId: partProfile.id,
+            assetPath: path,
+            valid: false,
+            targets: {},
+            diagnostics: [diagnostic],
+        };
+    }
+}
 export function createStompboxSourcePanelControls(document) {
     const componentsById = new Map(document.components.map((component) => [component.id, component]));
     const controls = [];
@@ -232,12 +232,14 @@ export function createStompboxSourcePanelControls(document) {
                 element.kind !== "footswitch") {
                 continue;
             }
+            const sourceControlId = controlIdForPanelElement(element);
             const sourceComponentId = element.bind.componentId;
             const component = sourceComponentId === undefined
                 ? undefined
                 : componentsById.get(sourceComponentId);
             const label = nonEmptyText(element.label) ??
                 nonEmptyText(component?.name) ??
+                nonEmptyText(sourceControlId) ??
                 nonEmptyText(sourceComponentId) ??
                 nonEmptyText(element.id) ??
                 "Control";
@@ -246,7 +248,7 @@ export function createStompboxSourcePanelControls(document) {
             const options = sourcePanelControlOptions(component);
             const description = sourcePanelControlPropertyText(component, "Description");
             controls.push({
-                id: sourceComponentId ??
+                id: sourceControlId ??
                     element.id ??
                     `${face.id}-${element.grid.row}-${element.grid.column}`,
                 label,
@@ -266,9 +268,7 @@ export function createStompboxControlSurface(document, options) {
     const diagnostics = [];
     const basePanel = extractPanel(document);
     const panelControls = createStompboxSourcePanelControls(document);
-    const sourceControls = panelControls.length === 0
-        ? sourceControlsFromExtractedPanel(basePanel)
-        : panelControls;
+    const sourceControls = mergeSourcePanelControls(panelControls, sourceControlsFromExtractedPanel(basePanel));
     const unmatchedCompiled = [...(options.compiledControls ?? [])];
     const descriptors = [];
     for (const sourceControl of sourceControls) {
@@ -568,7 +568,7 @@ export function createStompboxDrillLayout(document, options = {}) {
     const panelDeclared = [...declared, ...gridDeclared];
     const declaredControlIds = new Set(panelDeclared.flatMap((candidate) => candidate.controlId === undefined ? [] : [candidate.controlId]));
     const auto = autoPlacementCandidates(panel, enclosure, panelDeclared, declaredControlIds, options, hardwareProfile, placementStyle, diagnostics);
-    const holes = [...panelDeclared, ...auto].flatMap((candidate) => drillHoleForCandidate(candidate, hardwareProfile, diagnostics));
+    const holes = collapseConcentricMounts([...panelDeclared, ...auto], hardwareProfile, diagnostics).flatMap((candidate) => drillHoleForCandidate(candidate, hardwareProfile, diagnostics));
     diagnostics.push(...validateHolePlacements(holes, enclosure, options.minPartClearanceMm));
     return {
         schema: "stompbox-drill-layout/v1",
@@ -593,7 +593,27 @@ export function createStompboxPreview(document, options = {}) {
     const resolveOptions = assetResolveOptions(options);
     const runtimeState = options.pedalState?.controls ?? options.state;
     const enabled = options.pedalState?.enabled;
-    const parts = drillLayout.holes.map((hole) => previewPartForHole(hole, drillLayout.enclosure, controlMetadata.get(hole.controlId ?? ""), runtimeState, resolveOptions, options.appearance, enabled));
+    const parts = drillLayout.holes.flatMap((hole) => {
+        const base = previewPartForHole(hole, drillLayout.enclosure, controlMetadata.get(hole.controlId ?? ""), runtimeState, resolveOptions, options.appearance, enabled);
+        const dials = hole.concentricDials ?? [];
+        if (dials.length === 0) {
+            return [base];
+        }
+        const stacked = dials.map((dial) => {
+            const dialPart = previewPartForHole(concentricDialHole(hole, dial), drillLayout.enclosure, controlMetadata.get(dial.controlId ?? ""), runtimeState, resolveOptions, options.appearance, enabled);
+            return {
+                ...dialPart,
+                transform: {
+                    ...dialPart.transform,
+                    translationMm: {
+                        ...dialPart.transform.translationMm,
+                        z: dialPart.transform.translationMm.z + dial.stackOffsetMm,
+                    },
+                },
+            };
+        });
+        return [base, ...stacked];
+    });
     const decals = [
         ...normalizeDecals(options.decals, drillLayout.enclosure),
         ...controlLabelDecals(drillLayout, placementStyle, options.appearance),
@@ -825,6 +845,9 @@ export function createStompboxPreviewGlb(document, options = {}) {
         ? undefined
         : validateStompboxHardwareProfileAssets(hardwareProfile, {
             basePath: options.basePath,
+            ...(options.readAssetFile === undefined
+                ? {}
+                : { readAssetFile: options.readAssetFile }),
             partIds: liveStatePartProfileIdsForPreview(preview),
         });
     const diagnostics = [
@@ -936,6 +959,19 @@ function sourceControlsFromExtractedPanel(panel) {
         })),
     ];
 }
+function mergeSourcePanelControls(panelControls, extractedControls) {
+    if (panelControls.length === 0) {
+        return extractedControls;
+    }
+    const seenIds = new Set(panelControls.map((control) => control.id));
+    const seenComponents = new Set(panelControls.flatMap((control) => control.sourceComponentId === undefined ? [] : [control.sourceComponentId]));
+    return [
+        ...panelControls,
+        ...extractedControls.filter((control) => !seenIds.has(control.id) &&
+            (control.sourceComponentId === undefined ||
+                !seenComponents.has(control.sourceComponentId))),
+    ];
+}
 function findMatchingCompiledControlIndex(sourceControl, compiledControls, diagnostics) {
     if (sourceControl.sourceComponentId !== undefined) {
         const byComponent = compiledControls.findIndex((control) => control.sourceComponentId === sourceControl.sourceComponentId);
@@ -971,9 +1007,8 @@ function runtimeControlDescriptor(sourceControl, compiledControl) {
     const rawValue = compiledControl === undefined
         ? (sourceControl?.value ?? min)
         : effectiveCompiledControlValue(compiledControl);
-    const id = sourceControl?.sourceComponentId ??
+    const id = sourceControl?.id ??
         compiledControl?.sourceComponentId ??
-        sourceControl?.id ??
         publicRuntimeControlId(compiledControl?.id ?? compiledControl?.name ?? "control");
     const label = sourceControl?.label ?? compiledControl?.name ?? id;
     const normalizedValue = kind === "switch"
@@ -1412,6 +1447,12 @@ function requireStompboxHardwareProfile(options) {
     }
     return options.hardwareProfile;
 }
+function requireStompboxAssetFileReader(options) {
+    if (options.readAssetFile === undefined) {
+        throw new Error("stompbox GLB asset file access requires options.readAssetFile or the @vessel-dsp/stompbox/node export");
+    }
+    return options.readAssetFile;
+}
 function resolveStompboxPlacementStyle(profile, hardwareProfile) {
     return {
         defaultPartIds: {
@@ -1509,8 +1550,8 @@ function declaredPhysicalPlacements(faces, controls, hardwareProfile, defaultPar
             const metadata = controls.get(controlId);
             const requestedPartId = element.physical.partProfileId ??
                 defaultPartIdForPanelKind(element.kind, metadata, defaultPartIds);
-            const partId = knownPartIdOrDefault(requestedPartId, element.kind, metadata, hardwareProfile, defaultPartIds, diagnostics, controlId, element.id);
-            if (partId === undefined) {
+            const partResolution = knownPartIdOrDefault(requestedPartId, element.kind, metadata, hardwareProfile, defaultPartIds, diagnostics, controlId, element.id);
+            if (partResolution === undefined) {
                 diagnostics.push({
                     code: "unsupported-control",
                     message: `Unsupported declared panel element kind "${element.kind}"`,
@@ -1526,7 +1567,10 @@ function declaredPhysicalPlacements(faces, controls, hardwareProfile, defaultPar
                 kind: element.kind,
                 face: face.id,
                 centerMm: pointFromCorePoint(element.physical.centerMm),
-                partId,
+                partId: partResolution.partId,
+                ...(partResolution.partProvenance === undefined
+                    ? {}
+                    : { partProvenance: partResolution.partProvenance }),
                 componentId: element.bind.componentId,
                 controlId,
                 ...(label === undefined ? {} : { label }),
@@ -1536,7 +1580,15 @@ function declaredPhysicalPlacements(faces, controls, hardwareProfile, defaultPar
                 ...(element.physical.locked === undefined
                     ? {}
                     : { locked: element.physical.locked }),
-                provenance: "vdsp-declared",
+                ...(element.physical.mountId === undefined
+                    ? {}
+                    : { mountId: element.physical.mountId }),
+                ...(element.physical.surface === undefined
+                    ? {}
+                    : { surface: element.physical.surface }),
+                provenance: partResolution.partProvenance === "defaulted"
+                    ? "auto-generated"
+                    : "vdsp-declared",
             });
         }
     }
@@ -1553,8 +1605,8 @@ function gridPhysicalPlacements(faces, controls, enclosure, hardwareProfile, def
             const metadata = controls.get(controlId);
             const requestedPartId = element.physical?.partProfileId ??
                 defaultPartIdForPanelKind(element.kind, metadata, defaultPartIds);
-            const partId = knownPartIdOrDefault(requestedPartId, element.kind, metadata, hardwareProfile, defaultPartIds, diagnostics, controlId, element.id);
-            if (partId === undefined) {
+            const partResolution = knownPartIdOrDefault(requestedPartId, element.kind, metadata, hardwareProfile, defaultPartIds, diagnostics, controlId, element.id);
+            if (partResolution === undefined) {
                 diagnostics.push({
                     code: "unsupported-control",
                     message: `Unsupported panel grid element kind "${element.kind}"`,
@@ -1570,7 +1622,10 @@ function gridPhysicalPlacements(faces, controls, enclosure, hardwareProfile, def
                 kind: element.kind,
                 face: face.id,
                 centerMm: panelGridCenterMm(face, element, enclosure),
-                partId,
+                partId: partResolution.partId,
+                ...(partResolution.partProvenance === undefined
+                    ? {}
+                    : { partProvenance: partResolution.partProvenance }),
                 componentId: element.bind.componentId,
                 controlId,
                 ...(label === undefined ? {} : { label }),
@@ -1580,6 +1635,12 @@ function gridPhysicalPlacements(faces, controls, enclosure, hardwareProfile, def
                 ...(element.physical?.locked === undefined
                     ? {}
                     : { locked: element.physical.locked }),
+                ...(element.physical?.mountId === undefined
+                    ? {}
+                    : { mountId: element.physical.mountId }),
+                ...(element.physical?.surface === undefined
+                    ? {}
+                    : { surface: element.physical.surface }),
             }, diagnostics));
         }
     }
@@ -1752,6 +1813,92 @@ function autoCandidate(candidate, diagnostics) {
         provenance: "auto-generated",
     };
 }
+/**
+ * Collapses placement candidates that share a `mountId` onto a multi-surface
+ * part into a single base candidate carrying the upper dials as
+ * `concentricDials`. One mount becomes one drill hole with N stacked dials,
+ * ordered by the part profile's `surfaces`. Candidates without a `mountId`, or
+ * whose part declares no `surfaces`, pass through unchanged (one hole each).
+ */
+function collapseConcentricMounts(candidates, hardwareProfile, diagnostics) {
+    const result = [];
+    const groups = new Map();
+    for (const candidate of candidates) {
+        if (candidate.mountId === undefined) {
+            result.push(candidate);
+            continue;
+        }
+        const members = groups.get(candidate.mountId) ?? [];
+        members.push(candidate);
+        groups.set(candidate.mountId, members);
+    }
+    for (const [mountId, members] of groups) {
+        const part = hardwareProfile.partProfiles[members[0]?.partId ?? ""];
+        const surfaces = part?.surfaces;
+        if (part === undefined || surfaces === undefined || surfaces.length === 0) {
+            // Not a multi-surface part: keep each member as its own hole.
+            result.push(...members);
+            continue;
+        }
+        const memberBySurface = new Map();
+        for (const member of members) {
+            if (member.surface === undefined) {
+                result.push(member);
+                continue;
+            }
+            if (!surfaces.some((surface) => surface.id === member.surface)) {
+                diagnostics.push({
+                    code: "unknown-part-surface",
+                    message: `Mount "${mountId}" references surface "${member.surface}" not declared by part "${part.id}"`,
+                    ...(member.controlId === undefined
+                        ? {}
+                        : { controlId: member.controlId }),
+                    placementId: member.id,
+                    face: member.face,
+                });
+                result.push(member);
+                continue;
+            }
+            memberBySurface.set(member.surface, member);
+        }
+        const missing = surfaces.filter((surface) => !memberBySurface.has(surface.id));
+        if (missing.length > 0) {
+            diagnostics.push({
+                code: "concentric-mount-incomplete",
+                message: `Concentric mount "${mountId}" (part "${part.id}") is missing surface(s): ${missing.map((surface) => surface.id).join(", ")}`,
+                placementId: members[0]?.id ?? mountId,
+                face: members[0]?.face ?? "top",
+            });
+        }
+        const ordered = [];
+        for (const surface of surfaces) {
+            const member = memberBySurface.get(surface.id);
+            if (member !== undefined) {
+                ordered.push({ surface, member });
+            }
+        }
+        const base = ordered[0];
+        if (base === undefined) {
+            continue;
+        }
+        const upperDials = ordered
+            .slice(1)
+            .map(({ surface, member }) => ({
+            surface: surface.id,
+            partGeometry: surface.geometry,
+            stackOffsetMm: surface.stackOffsetMm,
+            ...(member.controlId === undefined
+                ? {}
+                : { controlId: member.controlId }),
+            ...(member.componentId === undefined
+                ? {}
+                : { componentId: member.componentId }),
+            ...(member.label === undefined ? {} : { label: member.label }),
+        }));
+        result.push({ ...base.member, concentricDials: upperDials });
+    }
+    return result;
+}
 function drillHoleForCandidate(candidate, hardwareProfile, diagnostics) {
     const part = hardwareProfile.partProfiles[candidate.partId];
     if (part === undefined) {
@@ -1779,6 +1926,9 @@ function drillHoleForCandidate(candidate, hardwareProfile, diagnostics) {
             partLabel: part.label,
             partFamily: part.family,
             partGeometry: part.geometry,
+            ...(candidate.partProvenance === undefined
+                ? {}
+                : { partProvenance: candidate.partProvenance }),
             ...(part.assetScale === undefined ? {} : { assetScale: part.assetScale }),
             ...(candidate.controlId === undefined
                 ? {}
@@ -1793,6 +1943,10 @@ function drillHoleForCandidate(candidate, hardwareProfile, diagnostics) {
             ...(part.stateTargets === undefined
                 ? {}
                 : { stateTargets: part.stateTargets }),
+            ...(candidate.concentricDials === undefined ||
+                candidate.concentricDials.length === 0
+                ? {}
+                : { concentricDials: candidate.concentricDials }),
         },
     ];
 }
@@ -1897,6 +2051,42 @@ function isOutOfBounds(hole, enclosure) {
     }
     return false;
 }
+/**
+ * Builds a synthetic drill hole for one upper dial of a concentric mount so it
+ * can be rendered as its own preview part. It reuses the base hole's position
+ * but carries the dial's geometry and control; the caller applies the dial's
+ * `stackOffsetMm` to lift it above the base dial.
+ */
+function concentricDialHole(hole, dial) {
+    return {
+        id: `${hole.id}-${dial.surface}`,
+        face: hole.face,
+        centerMm: hole.centerMm,
+        drillDiameterMm: hole.drillDiameterMm,
+        ...(hole.drillHoleProfileId === undefined
+            ? {}
+            : { drillHoleProfileId: hole.drillHoleProfileId }),
+        partId: hole.partId,
+        partLabel: hole.partLabel,
+        partFamily: hole.partFamily,
+        partGeometry: dial.partGeometry,
+        ...(hole.partProvenance === undefined
+            ? {}
+            : { partProvenance: hole.partProvenance }),
+        ...(hole.assetScale === undefined ? {} : { assetScale: hole.assetScale }),
+        ...(dial.controlId === undefined ? {} : { controlId: dial.controlId }),
+        ...(dial.componentId === undefined
+            ? {}
+            : { componentId: dial.componentId }),
+        ...(dial.label === undefined ? {} : { label: dial.label }),
+        provenance: hole.provenance,
+        ...(hole.locked === undefined ? {} : { locked: hole.locked }),
+        assets: hole.assets,
+        ...(hole.stateTargets === undefined
+            ? {}
+            : { stateTargets: hole.stateTargets }),
+    };
+}
 function previewPartForHole(hole, enclosure, metadata, state, assetOptions, appearance, enabled) {
     const rotation = baseRotationForFace(hole.face);
     const stateValue = stateValueForHole(hole, state, enabled);
@@ -1922,6 +2112,9 @@ function previewPartForHole(hole, enclosure, metadata, state, assetOptions, appe
         partId: hole.partId,
         family: hole.partFamily,
         geometry: hole.partGeometry,
+        ...(hole.partProvenance === undefined
+            ? {}
+            : { partProvenance: hole.partProvenance }),
         ...(hole.assetScale === undefined ? {} : { assetScale: hole.assetScale }),
         ...(hole.controlId === undefined ? {} : { controlId: hole.controlId }),
         face: hole.face,
@@ -3022,6 +3215,7 @@ function gltfAssemblySources(preview, options, assetValidation) {
         throw new Error("stompbox GLB assembly requires options.basePath for caller-provided asset files");
     }
     const basePath = options.basePath;
+    const readAssetFile = requireStompboxAssetFileReader(options);
     return [
         {
             id: preview.enclosure.variantId,
@@ -3029,6 +3223,7 @@ function gltfAssemblySources(preview, options, assetValidation) {
             displayGlb: preview.enclosure.assets.glb,
             displayStep: preview.enclosure.assets.step,
             localGlbPath: resolveStompboxAssetPaths(preview.drillLayout.enclosure.assets, { basePath }).glb,
+            readAssetFile,
             ...(preview.enclosure.material === undefined
                 ? {}
                 : { material: preview.enclosure.material }),
@@ -3051,10 +3246,10 @@ function gltfAssemblySources(preview, options, assetValidation) {
                     : { material: previewMaterialJson(preview.enclosure.material) }),
             },
         },
-        ...preview.parts.map((part) => partAssemblySource(part, preview.drillLayout, basePath, assetValidation?.assets[part.partId])),
+        ...preview.parts.map((part) => partAssemblySource(part, preview.drillLayout, basePath, readAssetFile, assetValidation?.assets[part.partId])),
     ];
 }
-function partAssemblySource(part, layout, basePath, validation) {
+function partAssemblySource(part, layout, basePath, readAssetFile, validation) {
     const sourceAssets = sourceAssetRefsForPreviewPart(layout, part);
     const sourceMaterial = part.geometry.kind === "led-bezel" ? undefined : part.material;
     const transform = {
@@ -3072,6 +3267,7 @@ function partAssemblySource(part, layout, basePath, validation) {
         displayGlb: part.assets.glb,
         displayStep: part.assets.step,
         localGlbPath: resolveStompboxAssetPaths(sourceAssets, { basePath }).glb,
+        readAssetFile,
         ...(sourceMaterial === undefined ? {} : { material: sourceMaterial }),
         ...(materialTargets.length === 0 ? {} : { materialTargets }),
         ...(stateTargets === undefined ? {} : { stateTargets }),
@@ -3082,6 +3278,9 @@ function partAssemblySource(part, layout, basePath, validation) {
             partId: part.partId,
             face: part.face,
             provenance: part.provenance,
+            ...(part.partProvenance === undefined
+                ? {}
+                : { partProvenance: part.partProvenance }),
             glb: part.assets.glb,
             step: part.assets.step,
             ...(part.assetScale === undefined ? {} : { assetScale: part.assetScale }),
@@ -3558,7 +3757,7 @@ function appendAssemblySource(state, source) {
     return wrapperIndex;
 }
 function appendSourceGlb(state, source) {
-    const parsed = parseGlbFile(source.localGlbPath);
+    const parsed = parseGlbFile(source.localGlbPath, source.readAssetFile);
     const bufferOffset = appendBinaryChunk(state, parsed.binary.slice(0, parsed.bufferByteLength));
     const sourceMaterials = jsonObjectArray(parsed.json, "materials");
     const bufferViewOffset = state.bufferViews.length;
@@ -3715,8 +3914,8 @@ function sourceSceneRootNodeIndexes(json) {
     }
     return nodes.flatMap((node) => (typeof node === "number" ? [node] : []));
 }
-function parseGlbFile(path) {
-    const bytes = new Uint8Array(readFileSync(path));
+function parseGlbFile(path, readAssetFile) {
+    const bytes = readAssetFile(path);
     return parseGlbBytes(bytes, path);
 }
 function parseGlbBytes(bytes, context) {
@@ -4412,7 +4611,7 @@ function defaultPartIdForPanelKind(kind, metadata, defaultPartIds) {
 function knownPartIdOrDefault(requestedPartId, kind, metadata, hardwareProfile, defaultPartIds, diagnostics, controlId, placementId) {
     if (requestedPartId !== undefined &&
         hardwareProfile.partProfiles[requestedPartId] !== undefined) {
-        return requestedPartId;
+        return { partId: requestedPartId, partProvenance: "vdsp-declared" };
     }
     if (requestedPartId !== undefined) {
         diagnostics.push({
@@ -4422,7 +4621,15 @@ function knownPartIdOrDefault(requestedPartId, kind, metadata, hardwareProfile,
             ...(placementId === undefined ? {} : { placementId }),
         });
     }
-    return defaultPartIdForPanelKind(kind, metadata, defaultPartIds);
+    const defaultPartId = defaultPartIdForPanelKind(kind, metadata, defaultPartIds);
+    return defaultPartId === undefined
+        ? undefined
+        : {
+            partId: defaultPartId,
+            ...(requestedPartId === undefined
+                ? {}
+                : { partProvenance: "defaulted" }),
+        };
 }
 function placementIdForKind(kind, controlId) {
     if (kind === "footswitch") {