simplesvelte 2.5.1 → 2.6.0

package/dist/Select.svelte

@@ -1,696 +1,720 @@
-<script lang="ts" module>
-	export type SelectOption = {
-		value: any
-		label: any
-		group?: string
-		[key: string]: any // Allow additional properties
-	}
-
-	export type SelectFetchParams = { filter: string | undefined }
-</script>
-
-<script lang="ts">
-	import Input from './Input.svelte'
-	import Label from './Label.svelte'
-
-	type Props = {
-		value?: string | number | undefined | null | (string | number)[]
-		options?: SelectOption[]
-		fetchOptions?: (params: SelectFetchParams) => Promise<SelectOption[]>
-		debounceMs?: number
-		name?: string
-		label?: string
-		class?: string
-		required?: boolean
-		placeholder?: string
-		disabled?: boolean
-		multiple?: boolean
-		error?: string
-		hideOptional?: boolean
-		dropdownMinWidth?: string
-		zodErrors?: {
-			expected: string
-			code: string
-			path: string[]
-			message: string
-		}[]
-		onchange?: (value: string | number | undefined | null | (string | number)[]) => void
-	}
-
-	let {
-		value = $bindable(undefined),
-		options: staticOptions = [],
-		fetchOptions,
-		debounceMs = 300,
-		name,
-		label,
-		class: className = '',
-		required = false,
-		disabled = false,
-		multiple = false,
-		placeholder = 'Select an item...',
-		error,
-		hideOptional,
-		dropdownMinWidth,
-		zodErrors,
-		onchange,
-	}: Props = $props()
-
-	// Async fetch state
-	let asyncItems = $state<SelectOption[]>([])
-	let isLoading = $state(false)
-	let fetchError = $state<string | undefined>(undefined)
-	let debounceTimeout: ReturnType<typeof setTimeout> | undefined
-
-	// Use async items if fetchOptions is provided, otherwise use static options
-	let items = $derived(fetchOptions ? asyncItems : staticOptions)
-
-	// Fetch options when filter changes (debounced)
-	async function fetchWithFilter(filterValue: string | undefined) {
-		if (!fetchOptions) return
-
-		// Clear previous timeout
-		if (debounceTimeout) clearTimeout(debounceTimeout)
-
-		debounceTimeout = setTimeout(async () => {
-			isLoading = true
-			fetchError = undefined
-			try {
-				asyncItems = await fetchOptions({ filter: filterValue })
-			} catch (err) {
-				fetchError = err instanceof Error ? err.message : 'Failed to fetch options'
-				asyncItems = []
-			} finally {
-				isLoading = false
-			}
-		}, debounceMs)
-	}
-
-	// Trigger fetch when dropdown opens or filter input changes (if using async)
-	$effect(() => {
-		if (fetchOptions && dropdownOpen) {
-			// Track filterInput to re-run when it changes
-			const currentFilter = filterInput
-			fetchWithFilter(currentFilter || undefined)
-		}
-	})
-
-	let dropdownOpen = $state(false)
-
-	// Generate unique ID for popover
-	const popoverId = `select-popover-${Math.random().toString(36).slice(2, 9)}`
-	const anchorName = `--anchor-${popoverId}`
-
-	// Ensure value is properly typed for single/multiple mode
-	// Normalize on access rather than maintaining separate state
-	let normalizedValue = $derived.by(() => {
-		if (multiple) {
-			// For multiple mode, always work with arrays
-			return Array.isArray(value) ? value : value ? [value] : []
-		} else {
-			// For single mode, extract first value if array
-			return Array.isArray(value) ? (value.length > 0 ? value[0] : undefined) : value
-		}
-	})
-
-	// For single select mode
-	let selectedItem = $derived.by(() => {
-		if (multiple) return null
-		const currentValue = normalizedValue
-		return items.find((item) => item.value === currentValue)
-	})
-	// For multi select mode
-	let selectedItems = $derived.by(() => {
-		if (!multiple) return []
-		const currentValue = normalizedValue
-		if (!Array.isArray(currentValue)) return []
-		return items.filter((item) => currentValue.includes(item.value))
-	})
-
-	// Remove specific item from multi-select
-	function toggleItemSelection(itemValue: any) {
-		if (!multiple) {
-			// Close dropdown and clear filter - the derived `filter` will show the label when closed
-			filterInput = ''
-			closeDropdown()
-			value = itemValue
-			if (onchange) onchange(value)
-			return
-		}
-
-		// For multiple selection, work with current array state
-		const currentValue = Array.isArray(normalizedValue) ? normalizedValue : []
-
-		if (currentValue.includes(itemValue)) {
-			value = currentValue.filter((v) => v !== itemValue)
-		} else {
-			value = [...currentValue, itemValue]
-		}
-		if (onchange) onchange(value)
-	}
-
-	// Remove specific item from multi-select
-	function removeSelectedItem(itemValue: any) {
-		const currentValue = normalizedValue
-		if (Array.isArray(currentValue)) {
-			value = currentValue.filter((v) => v !== itemValue)
-			if (onchange) onchange(value)
-		}
-	}
-
-	// Clear all selections
-	function clearAll() {
-		value = multiple ? [] : null
-		filterInput = ''
-		closeDropdown()
-		if (onchange) onchange(value)
-	}
-
-	// User's filter input - always editable
-	let filterInput = $state('')
-
-	// Display value in filter box for single-select when closed
-	let filter = $derived.by(() => {
-		// In single select mode when dropdown is closed, show selected item
-		if (!multiple && !dropdownOpen && selectedItem) {
-			return selectedItem.label
-		}
-		// Otherwise use the user's filter input
-		return filterInput
-	})
-
-	let filteredItems = $derived.by(() => {
-		// When using async fetch, server handles filtering - return items as-is
-		if (fetchOptions) return items
-		// Client-side filtering for static options
-		if (filter.length === 0) return items
-		return items.filter((item) => item.label.toLowerCase().includes(filter.toLowerCase()))
-	})
-
-	// Flatten filteredItems into a list with group headers and options for virtual scroll
-	type FlatListItem = { type: 'header'; group: string } | { type: 'option'; item: SelectOption }
-	let flatList = $derived.by(() => {
-		const result: FlatListItem[] = []
-		const groups: Record<string, SelectOption[]> = {}
-		const ungrouped: SelectOption[] = []
-
-		for (const item of filteredItems) {
-			if (item.group) {
-				if (!groups[item.group]) groups[item.group] = []
-				groups[item.group].push(item)
-			} else {
-				ungrouped.push(item)
-			}
-		}
-
-		// In multiple mode, separate selected and unselected items
-		if (multiple && Array.isArray(normalizedValue) && normalizedValue.length > 0) {
-			const selectedUngrouped: SelectOption[] = []
-			const unselectedUngrouped: SelectOption[] = []
-
-			for (const item of ungrouped) {
-				if (normalizedValue.includes(item.value)) {
-					selectedUngrouped.push(item)
-				} else {
-					unselectedUngrouped.push(item)
-				}
-			}
-
-			// Add selected ungrouped items first
-			for (const item of selectedUngrouped) {
-				result.push({ type: 'option', item })
-			}
-			// Then unselected ungrouped items
-			for (const item of unselectedUngrouped) {
-				result.push({ type: 'option', item })
-			}
-
-			// Add grouped items with headers, also with selected first within each group
-			for (const groupName of Object.keys(groups)) {
-				const groupItems = groups[groupName]
-				const selectedGroupItems = groupItems.filter((item) => normalizedValue.includes(item.value))
-				const unselectedGroupItems = groupItems.filter((item) => !normalizedValue.includes(item.value))
-
-				result.push({ type: 'header', group: groupName })
-				for (const item of selectedGroupItems) {
-					result.push({ type: 'option', item })
-				}
-				for (const item of unselectedGroupItems) {
-					result.push({ type: 'option', item })
-				}
-			}
-		} else {
-			// Normal ordering when not in multiple mode or no selections
-			for (const item of ungrouped) {
-				result.push({ type: 'option', item })
-			}
-			for (const groupName of Object.keys(groups)) {
-				result.push({ type: 'header', group: groupName })
-				for (const item of groups[groupName]) {
-					result.push({ type: 'option', item })
-				}
-			}
-		}
-
-		return result
-	})
-
-	let searchEL: HTMLInputElement | undefined = $state(undefined)
-	let popoverEl: HTMLElement | undefined = $state(undefined)
-	let scrollContainerEl: HTMLDivElement | undefined = $state(undefined)
-
-	// Keyboard navigation
-	let highlightedIndex = $state(-1)
-
-	// Get only the option entries from flatList (skip headers)
-	let optionIndices = $derived.by(() => {
-		const indices: number[] = []
-		for (let i = 0; i < flatList.length; i++) {
-			if (flatList[i].type === 'option') indices.push(i)
-		}
-		return indices
-	})
-
-	// Reset highlight when filter changes or dropdown closes
-	$effect(() => {
-		// Track filterInput to reset highlight when user types
-		void filterInput
-		if (!dropdownOpen) {
-			highlightedIndex = -1
-		}
-	})
-
-	// Scroll the virtual list to keep highlighted item visible
-	function scrollToHighlighted(index: number) {
-		if (!scrollContainerEl || index < 0) return
-		const targetTop = index * itemHeight
-		const targetBottom = targetTop + itemHeight
-		const viewTop = scrollContainerEl.scrollTop
-		const viewBottom = viewTop + containerHeight
-
-		if (targetTop < viewTop) {
-			scrollContainerEl.scrollTop = targetTop
-		} else if (targetBottom > viewBottom) {
-			scrollContainerEl.scrollTop = targetBottom - containerHeight
-		}
-	}
-
-	// Keyboard handler for arrow navigation
-	function handleKeydown(e: KeyboardEvent) {
-		if (e.key === 'ArrowDown') {
-			e.preventDefault()
-			if (!dropdownOpen) openDropdown()
-			// Move to next option (or first option if none highlighted)
-			const currentPos = optionIndices.indexOf(highlightedIndex)
-			const nextPos = currentPos + 1
-			if (nextPos < optionIndices.length) {
-				highlightedIndex = optionIndices[nextPos]
-				scrollToHighlighted(highlightedIndex)
-			}
-			searchEL?.focus()
-		} else if (e.key === 'ArrowUp') {
-			e.preventDefault()
-			if (!dropdownOpen) openDropdown()
-			// Move to previous option (or last option if none highlighted)
-			const currentPos = optionIndices.indexOf(highlightedIndex)
-			const prevPos = currentPos >= 0 ? currentPos - 1 : optionIndices.length - 1
-			if (prevPos >= 0) {
-				highlightedIndex = optionIndices[prevPos]
-				scrollToHighlighted(highlightedIndex)
-			}
-			searchEL?.focus()
-		} else if (e.key === 'Enter') {
-			e.preventDefault()
-			if (!dropdownOpen) {
-				openDropdown()
-				return
-			}
-			if (highlightedIndex >= 0) {
-				const entry = flatList[highlightedIndex]
-				if (entry && entry.type === 'option') {
-					toggleItemSelection(entry.item.value)
-					if (multiple) searchEL?.focus()
-				}
-			}
-		} else if (e.key === 'Escape') {
-			closeDropdown()
-		} else if (e.key === 'Tab') {
-			// Close dropdown on tab to allow normal tab navigation
-			closeDropdown()
-		}
-	}
-
-	// Virtual list implementation
-	let scrollTop = $state(0)
-	const itemHeight = 40 // Approximate height of each item in pixels
-	const containerHeight = 320 // max-h-80 = 320px
-	const visibleCount = Math.ceil(containerHeight / itemHeight) + 2 // Add buffer items
-
-	// Calculate visible items based on scroll position (for flatList)
-	let visibleItems = $derived.by(() => {
-		const total = flatList.length
-		const totalHeight = total * itemHeight
-
-		// If content is shorter than container, show everything from start
-		if (totalHeight <= containerHeight) {
-			return {
-				startIndex: 0,
-				endIndex: total,
-				items: flatList,
-				total,
-			}
-		}
-
-		const startIndex = Math.floor(scrollTop / itemHeight)
-		const endIndex = Math.min(startIndex + visibleCount, total)
-		return {
-			startIndex: Math.max(0, startIndex),
-			endIndex,
-			items: flatList.slice(Math.max(0, startIndex), endIndex),
-			total,
-		}
-	}) // Handle scroll events
-	function handleScroll(e: Event) {
-		const target = e.target as HTMLDivElement
-		scrollTop = target.scrollTop
-	}
-
-	// Scroll to selected item when dropdown opens
-	let hasScrolledOnOpen = false
-	function scrollToSelected(node: HTMLDivElement) {
-		const unsubscribe = $effect.root(() => {
-			$effect(() => {
-				if (dropdownOpen) {
-					// Only scroll on initial open, not on subsequent selection changes
-					if (hasScrolledOnOpen) return
-					hasScrolledOnOpen = true
-
-					// Find the index of the selected item in the flat list
-					let selectedIndex = -1
-
-					if (!multiple && selectedItem) {
-						// For single select, find the selected item
-						selectedIndex = flatList.findIndex(
-							(entry) => entry.type === 'option' && entry.item.value === selectedItem.value,
-						)
-					} else if (multiple && selectedItems.length > 0) {
-						// For multi select, find the first selected item
-						selectedIndex = flatList.findIndex(
-							(entry) =>
-								entry.type === 'option' && selectedItems.some((selected) => selected.value === entry.item.value),
-						)
-					}
-
-					if (selectedIndex >= 0) {
-						// Calculate scroll position to center the selected item
-						const targetScrollTop = Math.max(0, selectedIndex * itemHeight - containerHeight / 2 + itemHeight / 2)
-						// Set scroll position directly on the DOM node
-						node.scrollTop = targetScrollTop
-					}
-				} else {
-					// Reset flag when dropdown closes
-					hasScrolledOnOpen = false
-				}
-			})
-		})
-
-		return {
-			destroy() {
-				unsubscribe()
-			},
-		}
-	}
-
-	const errorText = $derived.by(() => {
-		if (error) return error
-		if (!name) return undefined
-		if (zodErrors) return zodErrors.find((e) => e.path.includes(name))?.message
-		return undefined
-	})
-
-	// Tooltip showing all selected items
-	const tooltipText = $derived.by(() => {
-		if (multiple && selectedItems.length > 0) {
-			return selectedItems.map((item) => item.label).join(', ')
-		} else if (!multiple && selectedItem) {
-			return selectedItem.label
-		}
-		return undefined
-	})
-
-	function openDropdown() {
-		if (!popoverEl) return
-		try {
-			if (!popoverEl.matches(':popover-open')) {
-				popoverEl.showPopover()
-			}
-		} catch {
-			// Ignore errors if popover is in an invalid state
-		}
-	}
-
-	function closeDropdown() {
-		if (!popoverEl) return
-		try {
-			// Check if open before hiding
-			if (popoverEl.matches(':popover-open')) {
-				popoverEl.hidePopover()
-			}
-		} catch {
-			// Ignore errors if popover is in an invalid state
-		}
-	}
-
-	// Handle popover toggle event to sync state
-	function handlePopoverToggle(e: ToggleEvent) {
-		dropdownOpen = e.newState === 'open'
-		if (dropdownOpen) {
-			searchEL?.focus()
-		} else {
-			hasScrolledOnOpen = false
-		}
-	}
-</script>
-
-<!-- Data inputs for form submission -->
-{#if multiple && Array.isArray(normalizedValue)}
-	{#each normalizedValue as val, i (val + '-' + i)}
-		<input type="hidden" {name} value={val} />
-	{/each}
-{:else if !multiple && normalizedValue !== undefined && normalizedValue !== null && normalizedValue !== ''}
-	<input type="hidden" {name} value={normalizedValue} />
-{/if}
-
-<Label {label} {name} optional={!required && !hideOptional} class={className} error={errorText}>
-	{#if !disabled}
-		<!-- Trigger button with popover target and anchor positioning -->
-		<button
-			type="button"
-			popovertarget={popoverId}
-			role="combobox"
-			aria-expanded={dropdownOpen}
-			aria-haspopup="listbox"
-			aria-controls={popoverId}
-			tabindex="-1"
-			class="select relative h-max min-h-10 w-full min-w-12 cursor-pointer bg-none! pr-1 text-left"
-			style="anchor-name: {anchorName}"
-			title={tooltipText}
-			onclick={() => {
-				searchEL?.focus()
-				// Only clear filter in single-select mode; in multi-select, keep filter for continued searching
-				if (!multiple) filterInput = ''
-			}}>
-			{#if multiple}
-				<!-- Multi-select display with condensed chips -->
-				<div class="flex min-h-8 flex-wrap gap-1 p-1">
-					{#if selectedItems.length > 0}
-						<!-- Show first selected item -->
-						<div class="badge badge-neutral bg-base-200 text-base-content gap-1">
-							<span class="max-w-50 truncate">{selectedItems[0].label}</span>
-							<!-- svelte-ignore a11y_click_events_have_key_events -->
-							<span
-								role="button"
-								tabindex="-1"
-								class="btn btn-xs btn-circle btn-ghost hover:bg-base-300"
-								onclick={(e) => {
-									e.stopPropagation()
-									removeSelectedItem(selectedItems[0].value)
-								}}>
-								✕
-							</span>
-						</div>
-
-						{#if selectedItems.length > 1}
-							<!-- Show count indicator for remaining items -->
-							<div class="badge badge-ghost text-base-content/70">
-								(+{selectedItems.length - 1} more)
-							</div>
-						{/if}
-					{/if}
-					<!-- Search input for filtering in multi-select -->
-					<input
-						type="text"
-						class="h-full min-w-30 flex-1 outline-0 {dropdownOpen ? 'cursor-text' : 'cursor-pointer'}"
-						bind:this={searchEL}
-						bind:value={filterInput}
-						onclick={() => openDropdown()}
-						onkeydown={handleKeydown}
-						placeholder="Search..."
-						required={required && (!Array.isArray(normalizedValue) || normalizedValue.length === 0)} />
-				</div>
-			{:else}
-				<!-- Single-select display -->
-				<input
-					type="text"
-					class="h-full w-full outline-0 {dropdownOpen ? 'cursor-text' : 'cursor-pointer'}"
-					bind:this={searchEL}
-					value={filter}
-					oninput={(e) => (filterInput = e.currentTarget.value)}
-					onclick={() => {
-						filterInput = ''
-						openDropdown()
-					}}
-					onkeydown={handleKeydown}
-					{placeholder}
-					required={required && !normalizedValue} />
-			{/if}
-			{#if !required && ((multiple && Array.isArray(normalizedValue) && normalizedValue.length > 0) || (!multiple && normalizedValue))}
-				<!-- svelte-ignore a11y_click_events_have_key_events -->
-				<span
-					role="button"
-					tabindex="-1"
-					class="btn btn-sm btn-circle btn-ghost bg-base-100 absolute top-1 right-1"
-					onclick={(e) => {
-						e.preventDefault()
-						e.stopPropagation()
-						clearAll()
-					}}>
-					✕
-				</span>
-			{/if}
-		</button>
-
-		<!-- Dropdown content using popover API -->
-		<ul
-			bind:this={popoverEl}
-			id={popoverId}
-			popover
-			role="listbox"
-			inert={!dropdownOpen}
-			class="dropdown menu bg-base-100 rounded-box z-50 m-0 flex flex-col flex-nowrap gap-1 p-2 shadow outline"
-			style="position-anchor: {anchorName}; position: fixed; top: anchor(bottom); left: anchor(left); width: anchor-size(width);{dropdownMinWidth ? ` min-width: ${dropdownMinWidth};` : ''} margin-block: 0.5rem; position-try-fallbacks: flip-block;"
-			ontoggle={handlePopoverToggle}>
-			{#if multiple && filteredItems.length > 1}
-				<!-- Select All / Clear All options for multi-select -->
-				<div class="flex gap-2">
-					<button
-						type="button"
-						class="btn btn-sm hover:bg-base-content/10 grow"
-						onclick={() => {
-							const allValues = filteredItems.map((item) => item.value)
-							value = [...allValues]
-							if (onchange) onchange(value)
-						}}>
-						Select All
-					</button>
-					<button
-						type="button"
-						class="btn btn-sm hover:bg-base-content/10 grow"
-						onclick={() => {
-							value = []
-							if (onchange) onchange(value)
-						}}>
-						Clear All
-					</button>
-				</div>
-			{/if}
-			{#if isLoading}
-				<li class="m-2 flex items-center justify-center gap-2 text-sm text-gray-500">
-					<span class="loading loading-spinner loading-sm"></span>
-					Loading...
-				</li>
-			{:else if fetchError}
-				<li class="text-error m-2 text-center text-sm">{fetchError}</li>
-			{:else if filteredItems.length === 0}
-				<li class="m-2 text-center text-sm text-gray-500">No items found</li>
-			{/if}
-
-			{#if flatList.length > 0}
-				<div
-					class="relative max-h-80 overflow-y-auto pr-2"
-					bind:this={scrollContainerEl}
-					use:scrollToSelected
-					onscroll={handleScroll}>
-					<!-- Virtual spacer for items before visible range -->
-					{#if visibleItems.startIndex > 0}
-						<div style="height: {visibleItems.startIndex * itemHeight}px;"></div>
-					{/if}
-
-					<!-- Render only visible items (headers and options) -->
-					{#each visibleItems.items as entry, idx (entry.type === 'header' ? 'header-' + entry.group + '-' + idx : 'option-' + entry.item.value + '-' + idx)}
-						{#if entry.type === 'header'}
-							<li
-								class="bg-base-200 top-0 z-10 flex items-center justify-center px-2 text-lg font-bold text-gray-700"
-								style="height: {itemHeight}px;">
-								{entry.group}
-							</li>
-						{:else}
-							{@const item = entry.item}
-							{@const flatIdx = visibleItems.startIndex + idx}
-							{@const isSelected = multiple
-								? Array.isArray(normalizedValue) && normalizedValue.includes(item.value)
-								: item.value === normalizedValue}
-							{@const isHighlighted = flatIdx === highlightedIndex}
-							<li style="height: {itemHeight}px;" role="option" aria-selected={isSelected}>
-								<button
-									class="flex h-full w-full items-center gap-2 {isSelected
-										? ' bg-primary text-primary-content hover:bg-primary/70!'
-										: ''} {isHighlighted && !isSelected ? 'bg-base-200' : ''}"
-									type="button"
-									onclick={(e) => {
-										e.stopPropagation()
-										toggleItemSelection(item.value)
-										if (multiple) searchEL?.focus()
-									}}>
-									{#if multiple}
-										<input
-											type="checkbox"
-											tabindex="-1"
-											class="checkbox checkbox-sm text-primary-content! pointer-events-none"
-											checked={isSelected}
-											readonly />
-									{/if}
-									<span class="flex-1 overflow-hidden text-left text-nowrap text-ellipsis">{item.label}</span>
-								</button>
-							</li>
-						{/if}
-					{/each}
-
-					<!-- Virtual spacer for items after visible range -->
-					{#if visibleItems.endIndex < visibleItems.total}
-						<div style="height: {(visibleItems.total - visibleItems.endIndex) * itemHeight}px;"></div>
-					{/if}
-				</div>
-			{/if}
-		</ul>
-	{:else}
-		<!-- Disabled state -->
-		{#if multiple}
-			<div class="flex min-h-12 flex-wrap gap-1 p-2">
-				{#each selectedItems as item (item.value)}
-					<div class="badge badge-ghost">{item.label}</div>
-				{/each}
-				{#if selectedItems.length === 0}
-					<span class="text-gray-500">No items selected</span>
-				{/if}
-			</div>
-		{:else}
-			<Input
-				type="text"
-				class="h-full w-full outline-0"
-				disabled
-				value={selectedItem ? selectedItem.label : ''}
-				readonly />
-		{/if}
-	{/if}
-</Label>
+<script lang="ts" module>
+	export type SelectOption = {
+		value: any
+		label: any
+		group?: string
+		[key: string]: any // Allow additional properties
+	}
+
+	export type SelectFetchParams = { filter: string | undefined }
+</script>
+
+<script lang="ts">
+	import Input from './Input.svelte'
+	import Label from './Label.svelte'
+
+	type Props = {
+		value?: string | number | undefined | null | (string | number)[]
+		options?: SelectOption[]
+		fetchOptions?: (params: SelectFetchParams) => Promise<SelectOption[]>
+		debounceMs?: number
+		name?: string
+		label?: string
+		class?: string
+		required?: boolean
+		placeholder?: string
+		disabled?: boolean
+		multiple?: boolean
+		error?: string
+		hideOptional?: boolean
+		dropdownMinWidth?: string
+		pending?: boolean
+		zodErrors?: {
+			expected: string
+			code: string
+			path: string[]
+			message: string
+		}[]
+		onchange?: (value: string | number | undefined | null | (string | number)[]) => void
+	}
+
+	let {
+		value = $bindable(undefined),
+		options: staticOptions = [],
+		fetchOptions,
+		debounceMs = 300,
+		name,
+		label,
+		class: className = '',
+		required = false,
+		disabled = false,
+		multiple = false,
+		placeholder = 'Select an item...',
+		error,
+		hideOptional,
+		dropdownMinWidth,
+		pending = false,
+		zodErrors,
+		onchange,
+	}: Props = $props()
+
+	// Async fetch state
+	let asyncItems = $state<SelectOption[]>([])
+	let isLoading = $state(false)
+	let fetchError = $state<string | undefined>(undefined)
+	let debounceTimeout: ReturnType<typeof setTimeout> | undefined
+
+	// Use async items if fetchOptions is provided, otherwise use static options
+	let items = $derived(fetchOptions ? asyncItems : staticOptions)
+
+	// Fetch options when filter changes (debounced)
+	async function fetchWithFilter(filterValue: string | undefined) {
+		if (!fetchOptions) return
+
+		// Clear previous timeout
+		if (debounceTimeout) clearTimeout(debounceTimeout)
+
+		debounceTimeout = setTimeout(async () => {
+			isLoading = true
+			fetchError = undefined
+			try {
+				asyncItems = await fetchOptions({ filter: filterValue })
+			} catch (err) {
+				fetchError = err instanceof Error ? err.message : 'Failed to fetch options'
+				asyncItems = []
+			} finally {
+				isLoading = false
+			}
+		}, debounceMs)
+	}
+
+	// Trigger fetch when dropdown opens or filter input changes (if using async)
+	$effect(() => {
+		if (fetchOptions && dropdownOpen) {
+			// Track filterInput to re-run when it changes
+			const currentFilter = filterInput
+			fetchWithFilter(currentFilter || undefined)
+		}
+	})
+
+	let dropdownOpen = $state(false)
+
+	// Generate unique ID for popover
+	const popoverId = `select-popover-${Math.random().toString(36).slice(2, 9)}`
+	const anchorName = `--anchor-${popoverId}`
+
+	// Ensure value is properly typed for single/multiple mode
+	// Normalize on access rather than maintaining separate state
+	let normalizedValue = $derived.by(() => {
+		if (multiple) {
+			// For multiple mode, always work with arrays
+			return Array.isArray(value) ? value : value ? [value] : []
+		} else {
+			// For single mode, extract first value if array
+			return Array.isArray(value) ? (value.length > 0 ? value[0] : undefined) : value
+		}
+	})
+
+	// For single select mode
+	let selectedItem = $derived.by(() => {
+		if (multiple) return null
+		const currentValue = normalizedValue
+		return items.find((item) => item.value === currentValue)
+	})
+	// For multi select mode
+	let selectedItems = $derived.by(() => {
+		if (!multiple) return []
+		const currentValue = normalizedValue
+		if (!Array.isArray(currentValue)) return []
+		return items.filter((item) => currentValue.includes(item.value))
+	})
+
+	// Remove specific item from multi-select
+	function toggleItemSelection(itemValue: any) {
+		if (!multiple) {
+			// Close dropdown and clear filter - the derived `filter` will show the label when closed
+			filterInput = ''
+			closeDropdown()
+			value = itemValue
+			if (onchange) onchange(value)
+			return
+		}
+
+		// For multiple selection, work with current array state
+		const currentValue = Array.isArray(normalizedValue) ? normalizedValue : []
+
+		if (currentValue.includes(itemValue)) {
+			value = currentValue.filter((v) => v !== itemValue)
+		} else {
+			value = [...currentValue, itemValue]
+		}
+		if (onchange) onchange(value)
+	}
+
+	// Remove specific item from multi-select
+	function removeSelectedItem(itemValue: any) {
+		const currentValue = normalizedValue
+		if (Array.isArray(currentValue)) {
+			value = currentValue.filter((v) => v !== itemValue)
+			if (onchange) onchange(value)
+		}
+	}
+
+	// Clear all selections
+	function clearAll() {
+		value = multiple ? [] : null
+		filterInput = ''
+		closeDropdown()
+		if (onchange) onchange(value)
+	}
+
+	// User's filter input - always editable
+	let filterInput = $state('')
+
+	// Display value in filter box for single-select when closed
+	let filter = $derived.by(() => {
+		// In single select mode when dropdown is closed, show selected item
+		if (!multiple && !dropdownOpen && selectedItem) {
+			return selectedItem.label
+		}
+		// Otherwise use the user's filter input
+		return filterInput
+	})
+
+
+	let filteredItems = $derived.by(() => {
+		// When using async fetch, server handles filtering - return items as-is
+		if (fetchOptions) return items
+		// Client-side filtering for static options
+		if (filter.length === 0) return items
+		return items.filter((item) => item.label.toLowerCase().includes(filter.toLowerCase()))
+	})
+
+	// Flatten filteredItems into a list with group headers and options for virtual scroll
+	type FlatListItem = { type: 'header'; group: string } | { type: 'option'; item: SelectOption }
+	let flatList = $derived.by(() => {
+		const result: FlatListItem[] = []
+		const groups: Record<string, SelectOption[]> = {}
+		const ungrouped: SelectOption[] = []
+
+		for (const item of filteredItems) {
+			if (item.group) {
+				if (!groups[item.group]) groups[item.group] = []
+				groups[item.group].push(item)
+			} else {
+				ungrouped.push(item)
+			}
+		}
+
+		// In multiple mode, separate selected and unselected items
+		if (multiple && Array.isArray(normalizedValue) && normalizedValue.length > 0) {
+			const selectedUngrouped: SelectOption[] = []
+			const unselectedUngrouped: SelectOption[] = []
+
+			for (const item of ungrouped) {
+				if (normalizedValue.includes(item.value)) {
+					selectedUngrouped.push(item)
+				} else {
+					unselectedUngrouped.push(item)
+				}
+			}
+
+			// Add selected ungrouped items first
+			for (const item of selectedUngrouped) {
+				result.push({ type: 'option', item })
+			}
+			// Then unselected ungrouped items
+			for (const item of unselectedUngrouped) {
+				result.push({ type: 'option', item })
+			}
+
+			// Add grouped items with headers, also with selected first within each group
+			for (const groupName of Object.keys(groups)) {
+				const groupItems = groups[groupName]
+				const selectedGroupItems = groupItems.filter((item) => normalizedValue.includes(item.value))
+				const unselectedGroupItems = groupItems.filter((item) => !normalizedValue.includes(item.value))
+
+				result.push({ type: 'header', group: groupName })
+				for (const item of selectedGroupItems) {
+					result.push({ type: 'option', item })
+				}
+				for (const item of unselectedGroupItems) {
+					result.push({ type: 'option', item })
+				}
+			}
+		} else {
+			// Normal ordering when not in multiple mode or no selections
+			for (const item of ungrouped) {
+				result.push({ type: 'option', item })
+			}
+			for (const groupName of Object.keys(groups)) {
+				result.push({ type: 'header', group: groupName })
+				for (const item of groups[groupName]) {
+					result.push({ type: 'option', item })
+				}
+			}
+		}
+
+		return result
+	})
+
+	let searchEL: HTMLInputElement | undefined = $state(undefined)
+	let popoverEl: HTMLElement | undefined = $state(undefined)
+	let scrollContainerEl: HTMLDivElement | undefined = $state(undefined)
+
+	// Keyboard navigation
+	let highlightedIndex = $state(-1)
+
+	// Get only the option entries from flatList (skip headers)
+	let optionIndices = $derived.by(() => {
+		const indices: number[] = []
+		for (let i = 0; i < flatList.length; i++) {
+			if (flatList[i].type === 'option') indices.push(i)
+		}
+		return indices
+	})
+
+	// Reset highlight when filter changes or dropdown closes
+	$effect(() => {
+		// Track filterInput to reset highlight when user types
+		void filterInput
+		if (!dropdownOpen) {
+			highlightedIndex = -1
+		}
+	})
+
+	// Scroll the virtual list to keep highlighted item visible
+	function scrollToHighlighted(index: number) {
+		if (!scrollContainerEl || index < 0) return
+		const targetTop = index * itemHeight
+		const targetBottom = targetTop + itemHeight
+		const viewTop = scrollContainerEl.scrollTop
+		const viewBottom = viewTop + containerHeight
+
+		if (targetTop < viewTop) {
+			scrollContainerEl.scrollTop = targetTop
+		} else if (targetBottom > viewBottom) {
+			scrollContainerEl.scrollTop = targetBottom - containerHeight
+		}
+	}
+
+	// Keyboard handler for arrow navigation
+	function handleKeydown(e: KeyboardEvent) {
+		if (e.key === 'ArrowDown') {
+			e.preventDefault()
+			if (!dropdownOpen) openDropdown()
+			// Move to next option (or first option if none highlighted)
+			const currentPos = optionIndices.indexOf(highlightedIndex)
+			const nextPos = currentPos + 1
+			if (nextPos < optionIndices.length) {
+				highlightedIndex = optionIndices[nextPos]
+				scrollToHighlighted(highlightedIndex)
+			}
+			searchEL?.focus()
+		} else if (e.key === 'ArrowUp') {
+			e.preventDefault()
+			if (!dropdownOpen) openDropdown()
+			// Move to previous option (or last option if none highlighted)
+			const currentPos = optionIndices.indexOf(highlightedIndex)
+			const prevPos = currentPos >= 0 ? currentPos - 1 : optionIndices.length - 1
+			if (prevPos >= 0) {
+				highlightedIndex = optionIndices[prevPos]
+				scrollToHighlighted(highlightedIndex)
+			}
+			searchEL?.focus()
+		} else if (e.key === 'Enter') {
+			e.preventDefault()
+			if (!dropdownOpen) {
+				openDropdown()
+				return
+			}
+			if (highlightedIndex >= 0) {
+				const entry = flatList[highlightedIndex]
+				if (entry && entry.type === 'option') {
+					toggleItemSelection(entry.item.value)
+					if (multiple) searchEL?.focus()
+				}
+			}
+		} else if (e.key === 'Escape') {
+			closeDropdown()
+		} else if (e.key === 'Tab') {
+			// Close dropdown on tab to allow normal tab navigation
+			closeDropdown()
+		}
+	}
+
+	// Virtual list implementation
+	let scrollTop = $state(0)
+	const itemHeight = 40 // Approximate height of each item in pixels
+	const containerHeight = 320 // max-h-80 = 320px
+	const visibleCount = Math.ceil(containerHeight / itemHeight) + 2 // Add buffer items
+
+	// Calculate visible items based on scroll position (for flatList)
+	let visibleItems = $derived.by(() => {
+		const total = flatList.length
+		const totalHeight = total * itemHeight
+
+		// If content is shorter than container, show everything from start
+		if (totalHeight <= containerHeight) {
+			return {
+				startIndex: 0,
+				endIndex: total,
+				items: flatList,
+				total,
+			}
+		}
+
+		const startIndex = Math.floor(scrollTop / itemHeight)
+		const endIndex = Math.min(startIndex + visibleCount, total)
+		return {
+			startIndex: Math.max(0, startIndex),
+			endIndex,
+			items: flatList.slice(Math.max(0, startIndex), endIndex),
+			total,
+		}
+	}) // Handle scroll events
+	function handleScroll(e: Event) {
+		const target = e.target as HTMLDivElement
+		scrollTop = target.scrollTop
+	}
+
+	// Scroll to selected item when dropdown opens
+	let hasScrolledOnOpen = false
+	function scrollToSelected(node: HTMLDivElement) {
+		const unsubscribe = $effect.root(() => {
+			$effect(() => {
+				if (dropdownOpen) {
+					// Only scroll on initial open, not on subsequent selection changes
+					if (hasScrolledOnOpen) return
+					hasScrolledOnOpen = true
+
+					// Find the index of the selected item in the flat list
+					let selectedIndex = -1
+
+					if (!multiple && selectedItem) {
+						// For single select, find the selected item
+						selectedIndex = flatList.findIndex(
+							(entry) => entry.type === 'option' && entry.item.value === selectedItem.value,
+						)
+					} else if (multiple && selectedItems.length > 0) {
+						// For multi select, find the first selected item
+						selectedIndex = flatList.findIndex(
+							(entry) =>
+								entry.type === 'option' && selectedItems.some((selected) => selected.value === entry.item.value),
+						)
+					}
+
+					if (selectedIndex >= 0) {
+						// Calculate scroll position to center the selected item
+						const targetScrollTop = Math.max(0, selectedIndex * itemHeight - containerHeight / 2 + itemHeight / 2)
+						// Set scroll position directly on the DOM node
+						node.scrollTop = targetScrollTop
+					}
+				} else {
+					// Reset flag when dropdown closes
+					hasScrolledOnOpen = false
+				}
+			})
+		})
+
+		return {
+			destroy() {
+				unsubscribe()
+			},
+		}
+	}
+
+	const errorText = $derived.by(() => {
+		if (error) return error
+		if (!name) return undefined
+		if (zodErrors) return zodErrors.find((e) => e.path.includes(name))?.message
+		return undefined
+	})
+
+	// Tooltip showing all selected items
+	const tooltipText = $derived.by(() => {
+		if (multiple && selectedItems.length > 0) {
+			return selectedItems.map((item) => item.label).join(', ')
+		} else if (!multiple && selectedItem) {
+			return selectedItem.label
+		}
+		return undefined
+	})
+
+	function openDropdown() {
+		if (!popoverEl) return
+		try {
+			if (!popoverEl.matches(':popover-open')) {
+				popoverEl.showPopover()
+			}
+		} catch {
+			// Ignore errors if popover is in an invalid state
+		}
+	}
+
+	function closeDropdown() {
+		if (!popoverEl) return
+		try {
+			// Check if open before hiding
+			if (popoverEl.matches(':popover-open')) {
+				popoverEl.hidePopover()
+			}
+		} catch {
+			// Ignore errors if popover is in an invalid state
+		}
+	}
+
+	// Handle popover toggle event to sync state
+	function handlePopoverToggle(e: ToggleEvent) {
+		dropdownOpen = e.newState === 'open'
+		if (dropdownOpen) {
+			searchEL?.focus()
+		} else {
+			hasScrolledOnOpen = false
+		}
+	}
+</script>
+
+<!-- Data inputs for form submission -->
+{#if multiple && Array.isArray(normalizedValue)}
+	{#each normalizedValue as val, i (val + '-' + i)}
+		<input type="hidden" {name} value={val} />
+	{/each}
+{:else if !multiple && normalizedValue !== undefined && normalizedValue !== null && normalizedValue !== ''}
+	<input type="hidden" {name} value={normalizedValue} />
+{/if}
+
+<Label {label} {name} optional={!required && !hideOptional} class={className} error={errorText}>
+	{#if !disabled}
+		<!-- Trigger button with popover target and anchor positioning -->
+		<button
+			type="button"
+			popovertarget={popoverId}
+			popovertargetaction="show"
+			role="combobox"
+			aria-expanded={dropdownOpen}
+			aria-haspopup="listbox"
+			aria-controls={popoverId}
+			tabindex="-1"
+			class="select relative h-max min-h-10 w-full min-w-12 cursor-pointer bg-none! pr-1 text-left"
+			style="anchor-name: {anchorName}"
+			title={tooltipText}
+			onclick={() => {
+				searchEL?.focus()
+				// Only clear filter in single-select mode; in multi-select, keep filter for continued searching
+				if (!multiple) filterInput = ''
+			}}>
+			{#if multiple}
+				<!-- Multi-select display with condensed chips -->
+				<div class="flex min-h-8 flex-wrap gap-1 p-1">
+					{#if selectedItems.length > 0}
+						<!-- Show first selected item -->
+						<div class="badge badge-neutral bg-base-200 text-base-content gap-1">
+							<span class="max-w-50 truncate">{selectedItems[0].label}</span>
+							<!-- svelte-ignore a11y_click_events_have_key_events -->
+							<span
+								role="button"
+								tabindex="-1"
+								class="btn btn-xs btn-circle btn-ghost hover:bg-base-300"
+								onclick={(e) => {
+									e.stopPropagation()
+									removeSelectedItem(selectedItems[0].value)
+								}}>
+								✕
+							</span>
+						</div>
+
+						{#if selectedItems.length > 1}
+							<!-- Show count indicator for remaining items -->
+							<div class="badge badge-ghost text-base-content/70">
+								(+{selectedItems.length - 1} more)
+							</div>
+						{/if}
+					{/if}
+					<!-- Search input for filtering in multi-select -->
+					<input
+						type="text"
+						class="h-full min-w-30 flex-1 outline-0 {dropdownOpen ? 'cursor-text' : 'cursor-pointer'}"
+						bind:this={searchEL}
+						bind:value={filterInput}
+						onclick={() => openDropdown()}
+						onkeydown={handleKeydown}
+						placeholder="Search..."
+						required={required && (!Array.isArray(normalizedValue) || normalizedValue.length === 0)} />
+				</div>
+			{:else}
+				<!-- Single-select display -->
+				<input
+					type="text"
+					class="h-full w-full pr-8 outline-0 {dropdownOpen ? 'cursor-text' : 'cursor-pointer'}"
+					bind:this={searchEL}
+					value={$state.eager(filter)}
+					oninput={(e) => (filterInput = e.currentTarget.value)}
+					onclick={() => {
+						filterInput = ''
+						openDropdown()
+					}}
+					onkeydown={handleKeydown}
+					{placeholder}
+					required={required && !normalizedValue} />
+			{/if}
+			<!-- Spinner: always in DOM so hidden attribute can be updated eagerly via $state.eager -->
+			{#if !multiple}
+				<span
+					aria-hidden="true"
+					class="loading loading-spinner loading-xs pointer-events-none absolute top-1/2 right-3 -translate-y-1/2"
+					hidden={!$state.eager(pending)}
+				></span>
+			{/if}
+			<!-- Clear button: hidden attribute updated eagerly so spinner and ✕ never overlap -->
+			{#if !required}
+				<!-- svelte-ignore a11y_click_events_have_key_events -->
+				<span
+					role="button"
+					tabindex="-1"
+					class="btn btn-sm btn-circle btn-ghost bg-base-100 absolute top-1 right-1"
+					hidden={!((multiple && Array.isArray(normalizedValue) && normalizedValue.length > 0) || (!multiple && normalizedValue)) ||
+					$state.eager(pending)}
+					onclick={(e) => {
+						e.preventDefault()
+						e.stopPropagation()
+						clearAll()
+					}}>
+					✕
+				</span>
+			{/if}
+		</button>
+
+		<!-- Dropdown content using popover API -->
+		<ul
+			bind:this={popoverEl}
+			id={popoverId}
+			popover
+			role="listbox"
+			inert={!dropdownOpen}
+			class="menu bg-base-100 rounded-box z-50 m-0 flex flex-col flex-nowrap gap-1 p-2 shadow outline"
+			style="position-anchor: {anchorName}; position: fixed; top: anchor(bottom); left: anchor(left); width: anchor-size(width);{dropdownMinWidth ? ` min-width: ${dropdownMinWidth};` : ''} margin-block: 0.5rem; position-try-fallbacks: flip-block;"
+			ontoggle={handlePopoverToggle}>
+			{#if multiple && filteredItems.length > 1}
+				<!-- Select All / Clear All options for multi-select -->
+				<div class="flex gap-2">
+					<button
+						type="button"
+						class="btn btn-sm hover:bg-base-content/10 grow"
+						onclick={() => {
+							const allValues = filteredItems.map((item) => item.value)
+							value = [...allValues]
+							if (onchange) onchange(value)
+						}}>
+						Select All
+					</button>
+					<button
+						type="button"
+						class="btn btn-sm hover:bg-base-content/10 grow"
+						onclick={() => {
+							value = []
+							if (onchange) onchange(value)
+						}}>
+						Clear All
+					</button>
+				</div>
+			{/if}
+			{#if isLoading}
+				<li class="m-2 flex items-center justify-center gap-2 text-sm text-gray-500">
+					<span class="loading loading-spinner loading-sm"></span>
+					Loading...
+				</li>
+			{:else if fetchError}
+				<li class="text-error m-2 text-center text-sm">{fetchError}</li>
+			{:else if filteredItems.length === 0}
+				<li class="m-2 text-center text-sm text-gray-500">No items found</li>
+			{/if}
+
+			{#if flatList.length > 0}
+				<div
+					class="relative max-h-80 overflow-y-auto pr-2"
+					bind:this={scrollContainerEl}
+					use:scrollToSelected
+					onscroll={handleScroll}>
+					<!-- Virtual spacer for items before visible range -->
+					{#if visibleItems.startIndex > 0}
+						<div style="height: {visibleItems.startIndex * itemHeight}px;"></div>
+					{/if}
+
+					<!-- Render only visible items (headers and options) -->
+					{#each visibleItems.items as entry, idx (entry.type === 'header' ? 'header-' + entry.group + '-' + idx : 'option-' + entry.item.value + '-' + idx)}
+						{#if entry.type === 'header'}
+							<li
+								class="bg-base-200 top-0 z-10 flex items-center justify-center px-2 text-lg font-bold text-gray-700"
+								style="height: {itemHeight}px;">
+								{entry.group}
+							</li>
+						{:else}
+							{@const item = entry.item}
+							{@const flatIdx = visibleItems.startIndex + idx}
+							{@const isSelected = multiple
+								? Array.isArray(normalizedValue) && normalizedValue.includes(item.value)
+								: item.value === normalizedValue}
+							{@const isHighlighted = flatIdx === highlightedIndex}
+							<li style="height: {itemHeight}px;" role="option" aria-selected={isSelected}>
+								<button
+									class="flex h-full w-full items-center gap-2 {isSelected
+										? ' bg-primary text-primary-content hover:bg-primary/70!'
+										: ''} {isHighlighted && !isSelected ? 'bg-base-200' : ''}"
+									type="button"
+									onclick={(e) => {
+										e.stopPropagation()
+										toggleItemSelection(item.value)
+										if (multiple) searchEL?.focus()
+									}}>
+									{#if multiple}
+										<input
+											type="checkbox"
+											tabindex="-1"
+											class="checkbox checkbox-sm text-primary-content! pointer-events-none"
+											checked={isSelected}
+											readonly />
+									{/if}
+									<span class="flex-1 overflow-hidden text-left text-nowrap text-ellipsis">{item.label}</span>
+								</button>
+							</li>
+						{/if}
+					{/each}
+
+					<!-- Virtual spacer for items after visible range -->
+					{#if visibleItems.endIndex < visibleItems.total}
+						<div style="height: {(visibleItems.total - visibleItems.endIndex) * itemHeight}px;"></div>
+					{/if}
+				</div>
+			{/if}
+		</ul>
+	{:else}
+		<!-- Disabled state -->
+		{#if multiple}
+			<div class="flex min-h-12 flex-wrap gap-1 p-2">
+				{#each selectedItems as item (item.value)}
+					<div class="badge badge-ghost">{item.label}</div>
+				{/each}
+				{#if selectedItems.length === 0}
+					<span class="text-gray-500">No items selected</span>
+				{/if}
+			</div>
+		{:else}
+			<Input
+				type="text"
+				class="h-full w-full outline-0"
+				disabled
+				value={selectedItem ? selectedItem.label : ''}
+				readonly />
+		{/if}
+	{/if}
+</Label>
+
+<style>
+	/* The `menu` DaisyUI class applies display:flex as an author style, which has higher
+	   cascade priority than the UA stylesheet's display:none for closed [popover] elements.
+	   This rule restores the correct hide behavior without relying on UA defaults. */
+	ul[popover]:not(:popover-open) {
+		display: none !important;
+	}
+</style>