@vessel-dsp/stompbox 0.6.4

package/dist/index.d.ts

@@ -0,0 +1,714 @@
+import { type CircuitDocument, type ControlState, type ControlValue, type Panel } from "@vessel-dsp/core";
+export type StompboxUnits = "mm";
+export type StompboxPlacementProvenance = "vdsp-declared" | "auto-generated";
+export type StompboxFaceId = "top" | "bottom" | "left" | "right" | "back" | (string & {});
+export type StompboxTemplateMode = "preview" | "print";
+export type StompboxStyleProfileId = string & {};
+export type StompboxKnobGridStrategy = "large-merged-row" | "compact-led-row";
+export type StompboxSideHardwareStrategy = "side-power-five-slot" | "back-power-paired-side-jacks";
+export type StompboxAudioJackLabelStrategy = "edge-rotated" | "inline";
+export type StompboxFootswitchStrategy = "lower-row" | "bottom-merged-row";
+export type StompboxStyleProfile = Readonly<{
+    id: StompboxStyleProfileId;
+    label: string;
+    supportedKnobCounts: readonly number[];
+    defaultPartIds?: Partial<StompboxDefaultPartProfileIds>;
+    layout?: Readonly<{
+        knobGrid?: StompboxKnobGridStrategy;
+        sideHardware?: StompboxSideHardwareStrategy;
+        audioJackLabels?: StompboxAudioJackLabelStrategy;
+        footswitch?: StompboxFootswitchStrategy;
+        statusLedLabel?: string;
+    }>;
+}>;
+export type StompboxStyleProfileFilter = Readonly<{
+    knobCount: number;
+}>;
+export declare function getAvailableStompboxStyleProfiles(profiles: readonly StompboxStyleProfile[], filter: StompboxStyleProfileFilter): readonly StompboxStyleProfile[];
+export type StompboxPoint2 = Readonly<{
+    x: number;
+    y: number;
+}>;
+export type StompboxPoint3 = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+}>;
+export type StompboxRotationDeg = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+}>;
+export type StompboxSize2 = Readonly<{
+    widthMm: number;
+    heightMm: number;
+}>;
+export type StompboxDecalGridPlacement = Readonly<{
+    kind: "grid";
+    columns: number;
+    rows: number;
+    column: number;
+    row: number;
+}>;
+export type StompboxDecalPlacement = StompboxDecalGridPlacement;
+export type StompboxDecalInputCommon = Readonly<{
+    id: string;
+    face?: StompboxFaceId;
+    centerMm?: StompboxPoint2;
+    placement?: StompboxDecalPlacement;
+    sizeMm?: StompboxSize2;
+    rotationDeg?: number;
+}>;
+export type StompboxTextDecalInput = StompboxDecalInputCommon & Readonly<{
+    kind: "text";
+    text: string;
+    color?: string;
+    fontFamily?: string;
+    fontSizeMm?: number;
+}>;
+export type StompboxSvgDecalInput = StompboxDecalInputCommon & Readonly<{
+    kind: "svg";
+    svg: string;
+    color?: string;
+}>;
+export type StompboxImageDecalInput = StompboxDecalInputCommon & Readonly<{
+    kind: "image";
+    href: string;
+    mimeType?: string;
+    color?: string;
+}>;
+export type StompboxDecalInput = StompboxTextDecalInput | StompboxSvgDecalInput | StompboxImageDecalInput;
+export type StompboxAssetRefs = Readonly<{
+    glbRelativePath: string;
+    stepRelativePath: string;
+}>;
+export type ResolvedStompboxAssetPaths = Readonly<{
+    glb: string;
+    step: string;
+}>;
+export type StompboxDrillHoleMarker = "ring-with-center-dot" | "center-dot";
+export type StompboxDrillHoleProfile = Readonly<{
+    id: string;
+    label: string;
+    diameterMm: number;
+    fractionInches: string;
+    marker: StompboxDrillHoleMarker;
+}>;
+export declare const STOMPBOX_DRILL_HOLE_PROFILE_CATALOG: Readonly<Record<string, StompboxDrillHoleProfile>>;
+export type StompboxAssetResolveOptions = Readonly<{
+    basePath?: string;
+    baseUrl?: string;
+}>;
+export type StompboxGlbStateTargetSelector = Readonly<{
+    nodeName?: string;
+    nodeNameIncludes?: string;
+    meshName?: string;
+    meshNameIncludes?: string;
+    materialName?: string;
+    materialNameIncludes?: string;
+    extras?: Readonly<Record<string, string | number | boolean>>;
+}>;
+export type StompboxGlbStateTargetRef = Readonly<{
+    selector: StompboxGlbStateTargetSelector;
+}>;
+export type StompboxFootswitchTravelAxis = "x" | "y" | "z";
+export type StompboxPartStateTargets = Readonly<{
+    led?: Readonly<{
+        lens: StompboxGlbStateTargetRef;
+    }>;
+    footswitch?: Readonly<{
+        actuator: StompboxGlbStateTargetRef;
+        travelMm?: number;
+        travelAxis?: StompboxFootswitchTravelAxis;
+    }>;
+}>;
+export type StompboxGlbStateTargetRole = "led.lens" | "footswitch.actuator";
+export type StompboxResolvedGlbStateTarget = Readonly<{
+    role: StompboxGlbStateTargetRole;
+    selector: StompboxGlbStateTargetSelector;
+    nodeName: string;
+    meshName?: string;
+    materialName?: string;
+    travelMm?: number;
+    travelAxis?: StompboxFootswitchTravelAxis;
+}>;
+export type StompboxResolvedPartStateTargets = Readonly<{
+    led?: Readonly<{
+        lens: StompboxResolvedGlbStateTarget;
+    }>;
+    footswitch?: Readonly<{
+        actuator: StompboxResolvedGlbStateTarget;
+    }>;
+}>;
+export type StompboxGlbAssetValidation = Readonly<{
+    schema: "stompbox-glb-asset-validation/v1";
+    partProfileId: string;
+    assetPath?: string;
+    valid: boolean;
+    targets: Readonly<Partial<Record<StompboxGlbStateTargetRole, StompboxResolvedGlbStateTarget>>>;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxHardwareProfileAssetValidation = Readonly<{
+    schema: "stompbox-hardware-profile-asset-validation/v1";
+    valid: boolean;
+    assets: Readonly<Record<string, StompboxGlbAssetValidation>>;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxGlbAssetValidationOptions = Readonly<{
+    assetPath?: string;
+}>;
+export type StompboxHardwareProfileAssetValidationOptions = StompboxAssetResolveOptions & Readonly<{
+    partIds?: readonly string[];
+}>;
+export type StompboxPartGeometry = Readonly<{
+    kind: "knob";
+    diameterMm: number;
+    depthMm: number;
+    shaftDiameterMm: number;
+}> | Readonly<{
+    kind: "led";
+    lensDiameterMm: number;
+    bodyHeightMm: number;
+    flangeDiameterMm: number;
+}> | Readonly<{
+    kind: "led-bezel";
+    outerDiameterMm: number;
+    innerDiameterMm: number;
+    depthMm: number;
+}> | Readonly<{
+    kind: "footswitch";
+    buttonDiameterMm: number;
+    nutOuterDiameterMm: number;
+    ringHeightMm: number;
+    buttonHeightMm: number;
+    pressedTravelMm: number;
+}> | Readonly<{
+    kind: "ring";
+    outerDiameterMm: number;
+    innerDiameterMm: number;
+    depthMm: number;
+}>;
+export type StompboxPartProfile = Readonly<{
+    id: string;
+    label: string;
+    family: "knob" | "led" | "footswitch" | "audio-jack" | "dc-jack";
+    level: "exterior";
+    status: "generated-stub";
+    panelHoleDrillMm: number;
+    drillHoleProfileId?: string;
+    geometry: StompboxPartGeometry;
+    assets: StompboxAssetRefs;
+    assetScale?: number;
+    stateTargets?: StompboxPartStateTargets;
+}>;
+export type StompboxPartProfileCatalog = Readonly<Record<string, StompboxPartProfile>>;
+export type StompboxEnclosureProfile = Readonly<{
+    variantId: string;
+    label: string;
+    dimensionsMm: Readonly<{
+        widthMm: number;
+        lengthMm: number;
+        depthMm: number;
+    }>;
+    topFace: Readonly<{
+        usableRectMm: Readonly<{
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }>;
+    assets: StompboxAssetRefs;
+}>;
+export type StompboxEnclosureProfileCatalog = Readonly<Record<string, StompboxEnclosureProfile>>;
+export type StompboxDefaultPartProfileIds = Readonly<{
+    knob: string;
+    largeKnob: string;
+    smallKnob: string;
+    led: string;
+    footswitch: string;
+    audioJack: string;
+    dcJack: string;
+}>;
+export type StompboxHardwareProfile = Readonly<{
+    id: string;
+    label: string;
+    partProfiles: StompboxPartProfileCatalog;
+    enclosureProfiles: StompboxEnclosureProfileCatalog;
+    defaultEnclosureId: string;
+    defaultPartIds: StompboxDefaultPartProfileIds;
+}>;
+export type StompboxHardwareProfileOptions = Readonly<{
+    hardwareProfile?: StompboxHardwareProfile;
+}>;
+export type StompboxDiagnosticCode = "placement-auto-generated" | "unsupported-control" | "unknown-part-profile" | "placement-collision" | "placement-clearance" | "placement-out-of-bounds" | "invalid-glb-asset" | "missing-state-target-contract" | "missing-state-target" | "ambiguous-state-target";
+export type StompboxDiagnostic = Readonly<{
+    code: StompboxDiagnosticCode;
+    message: string;
+    controlId?: string;
+    partId?: string;
+    placementId?: string;
+    face?: StompboxFaceId;
+    assetPath?: string;
+    targetRole?: StompboxGlbStateTargetRole;
+}>;
+export type StompboxDrillHole = Readonly<{
+    id: string;
+    face: StompboxFaceId;
+    centerMm: StompboxPoint2;
+    drillDiameterMm: number;
+    drillHoleProfileId?: string;
+    partId: string;
+    partLabel: string;
+    partFamily: StompboxPartProfile["family"];
+    partGeometry: StompboxPartGeometry;
+    assetScale?: number;
+    controlId?: string;
+    componentId?: string;
+    label?: string;
+    provenance: StompboxPlacementProvenance;
+    locked?: boolean;
+    assets: StompboxAssetRefs;
+    stateTargets?: StompboxPartStateTargets;
+}>;
+export type StompboxDrillLayout = Readonly<{
+    schema: "stompbox-drill-layout/v1";
+    units: StompboxUnits;
+    enclosure: StompboxEnclosureProfile;
+    holes: readonly StompboxDrillHole[];
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxPreviewMaterial = Readonly<{
+    color?: string;
+    strokeColor?: string;
+    offColor?: string;
+    pressedColor?: string;
+    emissive?: boolean;
+    intensity?: number;
+    metallicFactor?: number;
+    roughnessFactor?: number;
+    opacity?: number;
+}>;
+export type StompboxLabelAppearance = Readonly<{
+    text?: string;
+    color?: string;
+    fontFamily?: string;
+    fontSizeMm?: number;
+}>;
+export type StompboxAppearance = Readonly<{
+    enclosure?: StompboxPreviewMaterial;
+    template?: StompboxPreviewMaterial & Readonly<{
+        guideColor?: string;
+        foldColor?: string;
+        holeStrokeColor?: string;
+        holeFillColor?: string;
+        centerDotColor?: string;
+    }>;
+    defaults?: Readonly<{
+        led?: StompboxPreviewMaterial;
+        label?: StompboxLabelAppearance;
+        footswitch?: StompboxPreviewMaterial;
+        audioJack?: StompboxPreviewMaterial;
+        dcJack?: StompboxPreviewMaterial;
+    }>;
+    controls?: Readonly<Record<string, Readonly<{
+        led?: StompboxPreviewMaterial;
+        label?: StompboxLabelAppearance;
+        footswitch?: StompboxPreviewMaterial;
+        audioJack?: StompboxPreviewMaterial;
+        dcJack?: StompboxPreviewMaterial;
+    }>>>;
+    parts?: Readonly<Record<string, StompboxPreviewMaterial>>;
+    labels?: Readonly<Record<string, StompboxLabelAppearance>>;
+}>;
+export type StompboxAppearancePatchTarget = Readonly<{
+    targetId: string;
+    color?: string;
+    strokeColor?: string;
+    offColor?: string;
+    pressedColor?: string;
+    emissive?: boolean;
+    intensity?: number;
+    metallicFactor?: number;
+    roughnessFactor?: number;
+    opacity?: number;
+}>;
+export type StompboxPartAppearancePatchTarget = StompboxAppearancePatchTarget & Readonly<{
+    partId: string;
+    controlId?: string;
+    family: StompboxPartProfile["family"];
+}>;
+export type StompboxDecalAppearancePatchTarget = Readonly<{
+    targetId: string;
+    decalId: string;
+    kind: StompboxPreviewDecal["kind"];
+    face: StompboxFaceId;
+    text?: string;
+    color?: string;
+    fontFamily?: string;
+    fontSizeMm?: number;
+}>;
+export type StompboxResolvedAppearance = Readonly<{
+    schema: "stompbox-appearance-patch/v1";
+    units: StompboxUnits;
+    enclosure?: StompboxAppearancePatchTarget;
+    parts: Readonly<Record<string, StompboxPartAppearancePatchTarget>>;
+    decals: Readonly<Record<string, StompboxDecalAppearancePatchTarget>>;
+}>;
+export type StompboxPreviewPart = Readonly<{
+    id: string;
+    partId: string;
+    family: StompboxPartProfile["family"];
+    geometry: StompboxPartGeometry;
+    assetScale?: number;
+    controlId?: string;
+    face: StompboxFaceId;
+    provenance: StompboxPlacementProvenance;
+    assets: ResolvedStompboxAssetPaths;
+    stateTargets?: StompboxPartStateTargets;
+    transform: Readonly<{
+        translationMm: StompboxPoint3;
+        rotationDeg: StompboxRotationDeg;
+    }>;
+    material?: StompboxPreviewMaterial;
+}>;
+export type StompboxPreviewDecalCommon = Readonly<{
+    id: string;
+    face: StompboxFaceId;
+    centerMm: StompboxPoint2;
+    placement?: StompboxDecalPlacement;
+    sizeMm: StompboxSize2;
+    rotationDeg: number;
+}>;
+export type StompboxPreviewTextDecal = StompboxPreviewDecalCommon & Readonly<{
+    kind: "text";
+    text: string;
+    color: string;
+    fontFamily: string;
+    fontSizeMm: number;
+}>;
+export type StompboxPreviewSvgDecal = StompboxPreviewDecalCommon & Readonly<{
+    kind: "svg";
+    svg: string;
+    color?: string;
+}>;
+export type StompboxPreviewImageDecal = StompboxPreviewDecalCommon & Readonly<{
+    kind: "image";
+    href: string;
+    mimeType?: string;
+    color?: string;
+}>;
+export type StompboxPreviewDecal = StompboxPreviewTextDecal | StompboxPreviewSvgDecal | StompboxPreviewImageDecal;
+export type StompboxPreviewEnclosure = Omit<StompboxEnclosureProfile, "assets"> & Readonly<{
+    assets: ResolvedStompboxAssetPaths;
+    material?: StompboxPreviewMaterial;
+}>;
+export type StompboxPreview = Readonly<{
+    schema: "stompbox-preview/v1";
+    units: StompboxUnits;
+    enclosure: StompboxPreviewEnclosure;
+    parts: readonly StompboxPreviewPart[];
+    decals: readonly StompboxPreviewDecal[];
+    drillLayout: StompboxDrillLayout;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxRuntimeControlKind = "knob" | "switch";
+export type StompboxCompiledControlLike = Readonly<{
+    id: string;
+    sourceComponentId?: string;
+    name: string;
+    kind: "potentiometer" | "variableResistor" | "switch";
+    value: number;
+    defaultBehavior?: "noon" | "source";
+    min: number;
+    max: number;
+    step: number;
+    unit?: string;
+    sweep?: string;
+    options?: readonly string[];
+    targets?: readonly unknown[];
+}>;
+export type StompboxSourcePanelControl = Readonly<{
+    id: string;
+    label: string;
+    kind: StompboxRuntimeControlKind;
+    value: number;
+    sourceComponentId?: string;
+    panelElementId?: string;
+    sweep?: string;
+    options?: readonly string[];
+    description?: string;
+}>;
+export type StompboxRuntimeControlDescriptor = Readonly<{
+    id: string;
+    label: string;
+    kind: StompboxRuntimeControlKind;
+    source: "compiled" | "source-panel";
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    normalizedValue: ControlValue;
+    sourceComponentId?: string;
+    panelElementId?: string;
+    runtimeControlId?: string;
+    controlKind?: StompboxCompiledControlLike["kind"];
+    unit?: string;
+    sweep?: string;
+    options?: readonly string[];
+    description?: string;
+    targetCount?: number;
+}>;
+export type StompboxRuntimeControlRoute = Readonly<{
+    publicControlId: string;
+    runtimeControlId?: string;
+    sourceComponentId?: string;
+    kind: StompboxRuntimeControlKind;
+    source: "compiled" | "source-panel";
+    min: number;
+    max: number;
+    step: number;
+}>;
+export type StompboxControlSurface = Readonly<{
+    schema: "stompbox-control-surface/v1";
+    pedalId: string;
+    label?: string;
+    panel: Panel;
+    controls: readonly StompboxRuntimeControlDescriptor[];
+    routes: Readonly<Record<string, StompboxRuntimeControlRoute>>;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxPedalState = Readonly<{
+    schema: "stompbox-pedal-state/v1";
+    pedalId: string;
+    revision: number;
+    enabled: boolean;
+    controls: ControlState;
+}>;
+export type StompboxPedalStateCommand = Readonly<{
+    type: "set-enabled";
+    enabled: boolean;
+}> | Readonly<{
+    type: "set-control-value";
+    controlId: string;
+    value: ControlValue;
+}> | Readonly<{
+    type: "noop";
+}> | Readonly<{
+    type: "error";
+    reason: string;
+    controlId?: string;
+}>;
+export type StompboxRuntimeCommand = Readonly<{
+    kind: "set-control-value";
+    pedalId: string;
+    controlId: string;
+    publicControlId: string;
+    rawValue: number;
+}> | Readonly<{
+    kind: "set-enabled";
+    pedalId: string;
+    enabled: boolean;
+}> | Readonly<{
+    kind: "noop";
+}> | Readonly<{
+    kind: "error";
+    reason: string;
+    controlId?: string;
+}>;
+export type StompboxPedalStateChange = Readonly<{
+    previous: StompboxPedalState;
+    current: StompboxPedalState;
+    changedControlIds: readonly string[];
+    enabledChanged: boolean;
+    command: StompboxPedalStateCommand;
+}>;
+export type StompboxPedalStateListener = (event: StompboxPedalStateChange) => void;
+export type StompboxControlStateListener = (value: ControlValue | undefined, event: StompboxPedalStateChange) => void;
+export type StompboxPreviewStatePatchListener = (patch: StompboxPreviewStatePatch, event: StompboxPedalStateChange) => void;
+export type StompboxUnsubscribe = () => void;
+export type StompboxPedalStateStore = Readonly<{
+    getSnapshot(): StompboxPedalState;
+    dispatch(command: StompboxPedalStateCommand): StompboxPedalState;
+    setEnabled(enabled: boolean): StompboxPedalState;
+    setControlValue(controlId: string, value: ControlValue): StompboxPedalState;
+    turnKnob(controlId: string, position: number): StompboxPedalState;
+    pressFootswitch(partIdOrControlId: string, pressed: boolean): StompboxPedalState;
+    subscribe(listener: StompboxPedalStateListener): StompboxUnsubscribe;
+    subscribeControl(controlId: string, listener: StompboxControlStateListener): StompboxUnsubscribe;
+    subscribePreviewPatch(listener: StompboxPreviewStatePatchListener): StompboxUnsubscribe;
+}>;
+export type StompboxPreviewStatePatchTarget = Readonly<{
+    targetId: string;
+    previewPartId: string;
+    partId: string;
+    family: StompboxPartProfile["family"];
+    controlId?: string;
+    value?: ControlValue;
+    stateTarget?: StompboxResolvedGlbStateTarget;
+    transform?: StompboxPreviewPart["transform"];
+    material?: StompboxPreviewMaterial;
+}>;
+export type StompboxPreviewStatePatch = Readonly<{
+    schema: "stompbox-preview-state-patch/v1";
+    units: StompboxUnits;
+    pedalId: string;
+    revision: number;
+    parts: Readonly<Record<string, StompboxPreviewStatePatchTarget>>;
+}>;
+export type StompboxPreviewSvgViewId = "top" | "bottom" | "left" | "right" | "back";
+export type StompboxPreviewSvgViews = Readonly<{
+    schema: "stompbox-preview-svg-views/v1";
+    units: StompboxUnits;
+    preview: StompboxPreview;
+    views: Readonly<Record<StompboxPreviewSvgViewId, string>>;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxPreviewGlb = Readonly<{
+    schema: "stompbox-preview-glb/v1";
+    mimeType: "model/gltf-binary";
+    bytes: Uint8Array;
+    preview: StompboxPreview;
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxPreviewSvgGrainOptions = Readonly<{
+    baseFrequency?: number;
+    numOctaves?: number;
+    opacity?: number;
+}>;
+export type StompboxDrillTemplateHole = StompboxDrillHole & Readonly<{
+    templateCenterMm: StompboxPoint2;
+}>;
+export type StompboxDrillTemplateScaleMark = Readonly<{
+    id: string;
+    label: string;
+    lengthMm: number;
+    startMm: StompboxPoint2;
+    endMm: StompboxPoint2;
+}>;
+export type StompboxDrillTemplatePage = Readonly<{
+    paper: "A4";
+    orientation: "portrait";
+    widthMm: number;
+    heightMm: number;
+    marginMm: number;
+}>;
+export type StompboxDrillTemplate = Readonly<{
+    schema: "stompbox-drill-template/v1";
+    mode: StompboxTemplateMode;
+    units: StompboxUnits;
+    scale: 1;
+    detailLevel: "preview" | "fabrication-detail";
+    canvasMm: Readonly<{
+        widthMm: number;
+        heightMm: number;
+    }>;
+    page: StompboxDrillTemplatePage | undefined;
+    enclosure: StompboxEnclosureProfile;
+    holes: readonly StompboxDrillTemplateHole[];
+    decals: readonly StompboxPreviewDecal[];
+    appearance?: StompboxAppearance;
+    scaleMarks: readonly StompboxDrillTemplateScaleMark[];
+    holeTable: readonly StompboxDrillHole[];
+    diagnostics: readonly StompboxDiagnostic[];
+}>;
+export type StompboxLayoutOptions = StompboxHardwareProfileOptions & Readonly<{
+    enclosureId?: string;
+    includePowerJack?: boolean;
+    minPartClearanceMm?: number;
+    styleProfile?: StompboxStyleProfile;
+}>;
+export type StompboxFromVdspOptions = StompboxLayoutOptions & Readonly<{
+    filename?: string;
+}>;
+export type StompboxDecalOptions = Readonly<{
+    decals?: readonly StompboxDecalInput[];
+}>;
+export type StompboxAppearanceOptions = Readonly<{
+    appearance?: StompboxAppearance;
+}>;
+export type StompboxPreviewOptions = StompboxLayoutOptions & StompboxAssetResolveOptions & StompboxDecalOptions & StompboxAppearanceOptions & Readonly<{
+    state?: ControlState;
+    pedalState?: StompboxPedalState;
+}>;
+export type StompboxPreviewFromVdspOptions = StompboxPreviewOptions & Readonly<{
+    filename?: string;
+}>;
+export type StompboxDrillTemplateOptions = StompboxLayoutOptions & StompboxDecalOptions & StompboxAppearanceOptions & Readonly<{
+    mode: StompboxTemplateMode;
+}>;
+export type StompboxDrillTemplateFromVdspOptions = StompboxDrillTemplateOptions & Readonly<{
+    filename?: string;
+}>;
+export type StompboxPreviewSvgViewsOptions = StompboxPreviewOptions & Readonly<{
+    grain?: boolean | StompboxPreviewSvgGrainOptions;
+}>;
+export type StompboxPreviewSvgViewsFromVdspOptions = StompboxPreviewSvgViewsOptions & Readonly<{
+    filename?: string;
+}>;
+export type StompboxPreviewGlbOptions = StompboxPreviewOptions;
+export type StompboxPreviewGlbFromVdspOptions = StompboxPreviewGlbOptions & Readonly<{
+    filename?: string;
+}>;
+export declare function resolveStompboxAssetPaths(assets: StompboxAssetRefs, options?: StompboxAssetResolveOptions): ResolvedStompboxAssetPaths;
+export declare function validateStompboxGlbAsset(bytes: Uint8Array, partProfile: StompboxPartProfile, options?: StompboxGlbAssetValidationOptions): StompboxGlbAssetValidation;
+export declare function validateStompboxGlbAssetFile(path: string, partProfile: StompboxPartProfile): StompboxGlbAssetValidation;
+export declare function validateStompboxHardwareProfileAssets(hardwareProfile: StompboxHardwareProfile, options?: StompboxHardwareProfileAssetValidationOptions): StompboxHardwareProfileAssetValidation;
+export declare function createStompboxSourcePanelControls(document: CircuitDocument): readonly StompboxSourcePanelControl[];
+export declare function createStompboxControlSurface(document: CircuitDocument, options: Readonly<{
+    pedalId: string;
+    label?: string;
+    compiledControls?: readonly StompboxCompiledControlLike[];
+}>): StompboxControlSurface;
+export declare function createStompboxPanelFromControlSurface(surface: StompboxControlSurface): Panel;
+export declare function createDefaultStompboxPedalState(document: CircuitDocument, options: Readonly<{
+    pedalId: string;
+    enabled?: boolean;
+    compiledControls?: readonly StompboxCompiledControlLike[];
+}>): StompboxPedalState;
+export declare function createDefaultStompboxPedalStateFromVdsp(source: string, options: Readonly<{
+    pedalId: string;
+    filename?: string;
+    enabled?: boolean;
+    compiledControls?: readonly StompboxCompiledControlLike[];
+}>): StompboxPedalState;
+export declare function createStompboxPedalStateFromControlSurface(surface: StompboxControlSurface, options?: Readonly<{
+    enabled?: boolean;
+}>): StompboxPedalState;
+export declare function normalizeStompboxControlValue(descriptor: StompboxRuntimeControlDescriptor, rawValue: number): ControlValue;
+export declare function denormalizeStompboxControlValue(descriptor: StompboxRuntimeControlDescriptor, value: ControlValue): number;
+export declare function createStompboxRuntimeCommand(surface: StompboxControlSurface, command: StompboxPedalStateCommand): StompboxRuntimeCommand;
+export declare function setStompboxPedalEnabled(state: StompboxPedalState, enabled: boolean): StompboxPedalState;
+export declare function setStompboxControlValue(state: StompboxPedalState, controlId: string, value: ControlValue): StompboxPedalState;
+export declare function applyStompboxPedalStateCommand(state: StompboxPedalState, command: StompboxPedalStateCommand): StompboxPedalState;
+export declare function createStompboxKnobTurnCommand(surface: StompboxControlSurface, input: Readonly<{
+    controlId: string;
+    position: number;
+}>): StompboxPedalStateCommand;
+export declare function createStompboxFootswitchPressCommand(surface: StompboxControlSurface, input: Readonly<{
+    controlId?: string;
+    partId?: string;
+    pressed: boolean;
+}>): StompboxPedalStateCommand;
+export declare function applyStompboxPreviewInteraction(state: StompboxPedalState, command: StompboxPedalStateCommand): StompboxPedalState;
+export declare function createStompboxPedalStateStore(initialState: StompboxPedalState, options?: Readonly<{
+    preview?: StompboxPreview;
+}>): StompboxPedalStateStore;
+export declare function createStompboxDrillLayoutFromVdsp(source: string, options?: StompboxFromVdspOptions): StompboxDrillLayout;
+export declare function createStompboxDrillLayout(document: CircuitDocument, options?: StompboxLayoutOptions): StompboxDrillLayout;
+export declare function createStompboxPreviewFromVdsp(source: string, options?: StompboxPreviewFromVdspOptions): StompboxPreview;
+export declare function createStompboxPreview(document: CircuitDocument, options?: StompboxPreviewOptions): StompboxPreview;
+export declare function createStompboxPreviewStatePatch(preview: StompboxPreview, state: StompboxPedalState, previousState?: StompboxPedalState): StompboxPreviewStatePatch;
+export declare function applyStompboxPreviewStatePatch(preview: StompboxPreview, patch: StompboxPreviewStatePatch): StompboxPreview;
+export declare function resolveStompboxAppearance(preview: StompboxPreview, appearance?: StompboxAppearance): StompboxResolvedAppearance;
+export declare function createStompboxAppearancePatch(preview: StompboxPreview, appearance?: StompboxAppearance): StompboxResolvedAppearance;
+export declare function createStompboxDrillTemplateFromVdsp(source: string, options: StompboxDrillTemplateFromVdspOptions): StompboxDrillTemplate;
+export declare function createStompboxDrillTemplate(layout: StompboxDrillLayout, options: StompboxDrillTemplateOptions): StompboxDrillTemplate;
+export declare function createStompboxDrillTemplateSvgFromVdsp(source: string, options: StompboxDrillTemplateFromVdspOptions): string;
+export declare function createStompboxDrillTemplateSvg(layout: StompboxDrillLayout, options: StompboxDrillTemplateOptions): string;
+export declare function createStompboxPreviewSvgViewsFromVdsp(source: string, options?: StompboxPreviewSvgViewsFromVdspOptions): StompboxPreviewSvgViews;
+export declare function createStompboxPreviewSvgViews(document: CircuitDocument, options?: StompboxPreviewSvgViewsOptions): StompboxPreviewSvgViews;
+export declare function createStompboxPreviewGlbFromVdsp(source: string, options?: StompboxPreviewGlbFromVdspOptions): StompboxPreviewGlb;
+export declare function createStompboxPreviewGlb(document: CircuitDocument, options?: StompboxPreviewGlbOptions): StompboxPreviewGlb;
+export declare function knobRotationDegForPosition(position: number): number;
+//# sourceMappingURL=index.d.ts.map