eewing
138 lines
3.9 KiB
Svelte
138 lines
3.9 KiB
Svelte
<script lang="ts">
|
|
import { boxWith, mergeProps } from "svelte-toolbelt";
|
|
import { CommandRootState } from "../command.svelte.js";
|
|
import type { CommandRootProps } from "../types.js";
|
|
import CommandLabel from "./_command-label.svelte";
|
|
import { noop } from "../../../internal/noop.js";
|
|
import { createId } from "../../../internal/create-id.js";
|
|
import { computeCommandScore } from "../index.js";
|
|
|
|
const uid = $props.id();
|
|
|
|
let {
|
|
id = createId(uid),
|
|
ref = $bindable(null),
|
|
value = $bindable(""),
|
|
onValueChange = noop,
|
|
onStateChange = noop,
|
|
loop = false,
|
|
shouldFilter = true,
|
|
filter = computeCommandScore,
|
|
label = "",
|
|
vimBindings = true,
|
|
disablePointerSelection = false,
|
|
disableInitialScroll = false,
|
|
columns = null,
|
|
children,
|
|
child,
|
|
...restProps
|
|
}: CommandRootProps = $props();
|
|
|
|
const rootState = CommandRootState.create({
|
|
id: boxWith(() => id),
|
|
ref: boxWith(
|
|
() => ref,
|
|
(v) => (ref = v)
|
|
),
|
|
filter: boxWith(() => filter),
|
|
shouldFilter: boxWith(() => shouldFilter),
|
|
loop: boxWith(() => loop),
|
|
value: boxWith(
|
|
() => value,
|
|
(v) => {
|
|
if (value !== v) {
|
|
value = v;
|
|
onValueChange(v);
|
|
}
|
|
}
|
|
),
|
|
vimBindings: boxWith(() => vimBindings),
|
|
disablePointerSelection: boxWith(() => disablePointerSelection),
|
|
disableInitialScroll: boxWith(() => disableInitialScroll),
|
|
onStateChange: boxWith(() => onStateChange),
|
|
columns: boxWith(() => columns),
|
|
});
|
|
|
|
// Imperative APIs - DO NOT REMOVE OR RENAME
|
|
|
|
/**
|
|
* Sets selection to item at specified index in valid items array.
|
|
* If index is out of bounds, does nothing.
|
|
*
|
|
* @param index - Zero-based index of item to select
|
|
* @remarks
|
|
* Uses `getValidItems()` to get selectable items, filtering out disabled/hidden ones.
|
|
* Access valid items directly via `getValidItems()` to check bounds before calling.
|
|
*
|
|
* @example
|
|
* // get valid items length for bounds check
|
|
* const items = getValidItems()
|
|
* if (index < items.length) {
|
|
* updateSelectedToIndex(index)
|
|
* }
|
|
*/
|
|
export const updateSelectedToIndex: (typeof rootState)["updateSelectedToIndex"] = (i) =>
|
|
rootState.updateSelectedToIndex(i);
|
|
/**
|
|
* Moves selection to the first valid item in the next/previous group.
|
|
* If no group is found, falls back to selecting the next/previous item globally.
|
|
*
|
|
* @param change - Direction to move: 1 for next group, -1 for previous group
|
|
* @example
|
|
* // move to first item in next group
|
|
* updateSelectedByGroup(1)
|
|
*
|
|
* // move to first item in previous group
|
|
* updateSelectedByGroup(-1)
|
|
*/
|
|
export const updateSelectedByGroup: (typeof rootState)["updateSelectedByGroup"] = (c) =>
|
|
rootState.updateSelectedByGroup(c);
|
|
/**
|
|
* Updates selected item by moving up/down relative to current selection.
|
|
* Handles wrapping when loop option is enabled.
|
|
*
|
|
* @param change - Direction to move: 1 for next item, -1 for previous item
|
|
* @remarks
|
|
* The loop behavior wraps:
|
|
* - From last item to first when moving next
|
|
* - From first item to last when moving previous
|
|
*
|
|
* Uses `getValidItems()` to get all selectable items, which filters out disabled/hidden items.
|
|
* You can call `getValidItems()` directly to get the current valid items array.
|
|
*
|
|
* @example
|
|
* // select next item
|
|
* updateSelectedByItem(1)
|
|
*
|
|
* // get all valid items
|
|
* const items = getValidItems()
|
|
*/
|
|
export const updateSelectedByItem: (typeof rootState)["updateSelectedByItem"] = (c) =>
|
|
rootState.updateSelectedByItem(c);
|
|
/**
|
|
* Gets all non-disabled, visible command items.
|
|
*
|
|
* @returns Array of valid item elements
|
|
* @remarks Exposed for direct item access and bound checking
|
|
*/
|
|
export const getValidItems = () => rootState.getValidItems();
|
|
|
|
const mergedProps = $derived(mergeProps(restProps, rootState.props));
|
|
</script>
|
|
|
|
{#snippet Label()}
|
|
<CommandLabel>
|
|
{label}
|
|
</CommandLabel>
|
|
{/snippet}
|
|
|
|
{#if child}
|
|
{@render Label()}
|
|
{@render child({ props: mergedProps })}
|
|
{:else}
|
|
<div {...mergedProps}>
|
|
{@render Label()}
|
|
{@render children?.()}
|
|
</div>
|
|
{/if}
|