Initialization and Control

/**
 * Initialize selectpicker with optional configuration
 * @param options - Configuration object or method name for method calls
 * @param args - Additional arguments for method calls
 * @returns jQuery object for chaining
 */
$.fn.selectpicker(options?: SelectpickerOptions | string, ...args: any[]): JQuery;

// Auto-initialization via CSS class
$('.selectpicker').selectpicker();

// Initialize with options
$('.selectpicker').selectpicker({
  liveSearch: true,
  maxOptions: 5,
  size: 'auto'
});

// Initialize multiple elements with same config
$('select[data-role="selectpicker"]').selectpicker({
  style: 'btn-primary',
  width: '100%'
});

<!-- Auto-initialization with selectpicker class -->
<select class="selectpicker">
  <option>Option 1</option>
  <option>Option 2</option>
</select>

<!-- With data attributes for configuration -->
<select class="selectpicker" 
        data-live-search="true" 
        data-max-options="3"
        data-style="btn-success">
  <option>Option 1</option>
  <option>Option 2</option>
</select>

/**
 * Direct access to Selectpicker constructor
 */
$.fn.selectpicker.Constructor: typeof Selectpicker;

/**
 * Selectpicker constructor for manual instantiation
 * @param element - HTML select element
 * @param options - Configuration options
 */
class Selectpicker {
  constructor(element: HTMLSelectElement, options: SelectpickerOptions);
}

// Manual instantiation
const selectElement = document.querySelector('#mySelect');
const picker = new $.fn.selectpicker.Constructor(selectElement, {
  liveSearch: true
});

// Access constructor for type checking
if (data instanceof $.fn.selectpicker.Constructor) {
  // Handle selectpicker instance
}

/**
 * Restore previous $.fn.selectpicker value and return selectpicker
 * @returns The selectpicker function
 */
$.fn.selectpicker.noConflict(): typeof $.fn.selectpicker;

// Save reference before potential conflicts
const bootstrapSelect = $.fn.selectpicker.noConflict();

// Use saved reference
$('.my-select').bootstrapSelect();

/**
 * Destroy selectpicker instance and restore original select
 */
.selectpicker('destroy'): JQuery;

/**
 * Remove selectpicker instance (alias for destroy)
 */
.selectpicker('remove'): JQuery;

// Initialize selectpicker
$('#mySelect').selectpicker();

// Later destroy the instance
$('#mySelect').selectpicker('destroy');

// Or use remove (same as destroy)
$('#mySelect').selectpicker('remove');

// Re-initialize after destruction
$('#mySelect').selectpicker({
  liveSearch: true
});

/**
 * Call method on selectpicker instance
 * @param method - Method name to call
 * @param args - Arguments to pass to method
 * @returns Method return value or jQuery object
 */
.selectpicker(method: string, ...args: any[]): any;

// Get current value
const value = $('#mySelect').selectpicker('val');

// Set new value
$('#mySelect').selectpicker('val', 'option2');

// Call method with multiple arguments
$('#mySelect').selectpicker('setStyle', 'btn-danger', 'add');

// Chain method calls
$('#mySelect')
  .selectpicker('selectAll')
  .selectpicker('render');

/**
 * Manually specify Bootstrap version for compatibility
 */
$.fn.selectpicker.Constructor.BootstrapVersion: '3' | '4';

// Force Bootstrap 3 compatibility
$.fn.selectpicker.Constructor.BootstrapVersion = '3';

// Force Bootstrap 4 compatibility  
$.fn.selectpicker.Constructor.BootstrapVersion = '4';

// Auto-detection (default behavior)
delete $.fn.selectpicker.Constructor.BootstrapVersion;