/**
 * Declarative MIDI binding system using HTML data attributes. Enables zero-JavaScript
 * MIDI controller creation by scanning the DOM for data-midi-* attributes and automatically
 * binding elements to MIDIController.
 *
 * Features:
 * - **Auto-discovery**: Scans DOM for data-midi-* attributes
 * - **7-bit CC**: Bind with `data-midi-cc="74"` (e.g., Filter Cutoff)
 * - **14-bit CC**: Bind with `data-midi-msb="74" data-midi-lsb="75"` for high resolution
 * - **Custom ranges**: Use HTML min/max attributes or `data-midi-min`/`data-midi-max`
 * - **Channel override**: `data-midi-channel="2"` to use channel 2 instead of default
 * - **Value inversion**: `data-midi-invert="true"` to invert the value mapping
 * - **De bouncing**: `data-midi-debounce="100"` for high-frequency updates (ms)
 * - **Auto-binding**: Watch DOM for dynamically added/removed elements with MutationObserver
 * - **Labeling**: `data-midi-label="Filter Cutoff"` for patch saving
 *
 * @example
 * // 7-bit CC binding
 * <input type="range" min="0" max="127" data-midi-cc="74" data-midi-label="Filter Cutoff">
 *
 * @example
 * // 14-bit high-resolution binding
 * <input type="range" min="0" max="16383" data-midi-msb="74" data-midi-lsb="75" data-midi-label="Pitch Bend">
 *
 * @example
 * // With channel override and inversion
 * <input type="range" min="0" max="127" data-midi-cc="7" data-midi-channel="2" data-midi-invert="true" data-midi-label="Volume">
 *
 * @example
 * // With custom range
 * <input type="range" min="-100" max="100" data-midi-cc="10" data-midi-label="Pan">
 *
 * @example
 * // Complete setup with auto-binding
 * const midi = new MIDIController();
 * const binder = new DataAttributeBinder(midi);
 *
 * // Bind existing elements
 * binder.bindAll();
 *
 * // Enable auto-binding for dynamically added elements
 * binder.enableAutoBinding();
 *
 * @example
 * // Manual binding with custom selector
 * const binder = new DataAttributeBinder(midi, "[data-midi-cc]");
 * binder.bindAll();
 */
export class DataAttributeBinder {
    /**
     * Create a new DataAttributeBinder instance for declarative MIDI binding
     *
     * @param {MIDIController} controller - MIDIController instance to bind elements to
     * @param {string} [selector="[data-midi-cc]"] - CSS selector for elements to bind. Defaults to looking for data-midi-cc or data-midi-msb/lmb attributes
     *
     * @example
     * // Basic usage
     * const midi = new MIDIController();
     * const binder = new DataAttributeBinder(midi);
     *
     * @example
     * // With custom selector
     * const binder = new DataAttributeBinder(midi, ".midi-control");
     *
     * @example
     * // Bind after MIDI is ready
     * const midi = new MIDIController();
     * midi.on(midi.READY, () => {
     *   const binder = new DataAttributeBinder(midi);
     *   binder.bindAll();
     * });
     */
    constructor(controller: MIDIController, selector?: string);
    controller: MIDIController;
    selector: string;
    observer: MutationObserver;
    /**
     * Bind all matching elements in the document to MIDI Controller. Searches the DOM for elements
     * that match the selector and have data-midi-* attributes. Skips already bound elements (marked
     * with data-midi-bound attribute). Automatically handles both 7-bit CC and 14-bit CC configurations.
     *
     * @returns {void}
     *
     * @example
     * // Bind all elements with data-midi-cc or data-midi-msb/lmb attributes
     * binder.bindAll();
     *
     * @example
     * // Bind after DOM is loaded
     * document.addEventListener("DOMContentLoaded", () => {
     *   binder.bindAll();
     * });
     *
     * @example
     * // Bind after MIDI is ready
     * midi.on(midi.READY, () => {
     *   binder.bindAll();
     * });
     */
    bindAll(): void;
    /**
     * Enable automatic binding of dynamically added elements using MutationObserver.
     * Watches the DOM for new elements that match the selector and have data-midi-* attributes,
     * automatically binding them when they're added. Also handles cleanup of removed elements.
     *
     * @returns {void}
     *
     * @example
     * // Enable and forget - perfect for single page apps
     * binder.enableAutoBinding();
     *
     * @example
     * // Add controls dynamically
     * binder.enableAutoBinding();
     * // Later, when you add new UI controls:
     * const newSlider = document.createElement("input");
     * newSlider.type = "range";
     * newSlider.setAttribute("data-midi-cc", "71");
     * document.getElementById("controls").appendChild(newSlider);
     * // Automatically bound!
     */
    enableAutoBinding(): void;
    /**
     * Disable automatic binding and clean up the MutationObserver. Stops watching for
     * dynamically added/removed elements and disconnects the observer to prevent memory leaks.
     *
     * @returns {void}
     *
     * @example
     * // Temporarily disable auto-binding
     * binder.disableAutoBinding();
     * // Make bulk DOM changes
     * updateAllControls();
     * // Re-enable when done
     * binder.enableAutoBinding();
     *
     * @example
     * // Clean up when done with the binder
     * binder.disableAutoBinding();
     * binder.destroy();
     */
    disableAutoBinding(): void;
    /**
     * Parse MIDI configuration from an element's data attributes. Extracts MIDI binding
     * configuration including CC numbers, channel, range, inversion, and debouncing settings.
     * Validates the configuration and returns null if invalid. Handles both 7-bit CC
     * (data-midi-cc) and 14-bit CC (data-midi-msb + data-midi-lsb) configurations.
     *
     * @param {HTMLElement} element - The element to parse attributes from
     * @returns {Object|null} Configuration object or null if invalid
     * @private
     *
     * @example
     * // 7-bit CC configuration
     * // <input type="range" min="0" max="127" data-midi-cc="74" data-midi-invert="true">
     * // Returns: { cc: 74, min: 0, max: 127, invert: true }
     *
     * @example
     * // 14-bit CC configuration
     * // <input type="range" min="0" max="16383" data-midi-msb="74" data-midi-lsb="75">
     * // Returns: { msb: 74, lsb: 75, is14Bit: true, min: 0, max: 16383 }
     */
    private _parseAttributes;
    /**
     * Clean up resources and disconnect any active observers. Disables auto-binding if active
     * and disconnects the MutationObserver to prevent memory leaks. Call this when done with
     * the binder instance.
     *
     * @returns {void}
     *
     * @example
     * // Clean up when done
     * const binder = new DataAttributeBinder(midi);
     * binder.bindAll();
     * binder.enableAutoBinding();
     *
     * // Later, when cleaning up
     * binder.destroy();
     *
     * @example
     * // Clean up in response to user action
     * document.getElementById("cleanup-btn").addEventListener("click", () => {
     *   binder.destroy();
     * });
     */
    destroy(): void;
}
//# sourceMappingURL=DataAttributeBinder.d.ts.map