sheer-ui 0.0.0

package/src/lib/components/command/components/_command-label.svelte

@@ -0,0 +1,31 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { CommandLabelState } from '../command.svelte.js';
+
+	import type { WithChildren } from '../../../internal/types.js';
+	import { createId } from '../../../internal/create-id.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { BitsPrimitiveLabelAttributes, WithElementRef } from '../../../internal/index.js';
+
+	const uid = $props.id();
+	let {
+		id = createId(uid),
+		ref = $bindable(null),
+		children,
+		...restProps
+	}: WithChildren<WithElementRef<BitsPrimitiveLabelAttributes>> = $props();
+
+	const labelState = CommandLabelState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+	});
+
+	const mergedProps = $derived(mergeProps(restProps, labelState.props));
+</script>
+
+<label {...mergedProps}>
+	{@render children?.()}
+</label>

package/src/lib/components/command/components/command-empty.svelte

@@ -0,0 +1,34 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandEmptyProps } from '../types.js';
+	import { CommandEmptyState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), children, child, forceMount = false, ...restProps }: CommandEmptyProps = $props();
+
+	const emptyState = CommandEmptyState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		forceMount: boxWith(() => forceMount),
+	});
+
+	const mergedProps = $derived(
+		mergeProps({ 'data-slot': 'command-empty', class: 'py-6 text-center text-sm' }, restProps, emptyState.props),
+	);
+</script>
+
+{#if emptyState.shouldRender}
+	{#if child}
+		{@render child({ props: mergedProps })}
+	{:else}
+		<div {...mergedProps}>
+			{@render children?.()}
+		</div>
+	{/if}
+{/if}

package/src/lib/components/command/components/command-group-heading.svelte

@@ -0,0 +1,29 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import { CommandGroupHeadingState } from '../command.svelte.js';
+	import type { CommandGroupHeadingProps } from '../types.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), children, child, ...restProps }: CommandGroupHeadingProps = $props();
+
+	const headingState = CommandGroupHeadingState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+	});
+
+	const mergedProps = $derived(mergeProps(restProps, headingState.props));
+</script>
+
+{#if child}
+	{@render child({ props: mergedProps })}
+{:else}
+	<div {...mergedProps}>
+		{@render children?.()}
+	</div>
+{/if}

package/src/lib/components/command/components/command-group-items.svelte

@@ -0,0 +1,31 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandGroupItemsProps } from '../types.js';
+	import { CommandGroupItemsState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), children, child, ...restProps }: CommandGroupItemsProps = $props();
+
+	const groupItemsState = CommandGroupItemsState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+	});
+
+	const mergedProps = $derived(mergeProps(restProps, groupItemsState.props));
+</script>
+
+<div class="contents">
+	{#if child}
+		{@render child({ props: mergedProps })}
+	{:else}
+		<div {...mergedProps}>
+			{@render children?.()}
+		</div>
+	{/if}
+</div>

package/src/lib/components/command/components/command-group.svelte

@@ -0,0 +1,76 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandGroupProps } from '../types.js';
+	import { CommandGroupContainerState, CommandGroupHeadingState, CommandGroupItemsState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+	const headingId = createId('command-group-heading', uid);
+	const itemsId = createId('command-group-items', uid);
+
+	let headingRef = $state<HTMLElement | null>(null);
+	let itemsRef = $state<HTMLElement | null>(null);
+
+	let {
+		id = createId(uid),
+		ref = $bindable(null),
+		value,
+		forceMount = false,
+		children,
+		child,
+		heading,
+		...restProps
+	}: CommandGroupProps & {
+		heading?: string;
+	} = $props();
+
+	const groupState = CommandGroupContainerState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		forceMount: boxWith(() => forceMount),
+		value: boxWith(() => value ?? heading ?? `----${id}`),
+	});
+
+	const headingState = CommandGroupHeadingState.create({
+		id: boxWith(() => headingId),
+		ref: boxWith(
+			() => headingRef,
+			(v) => (headingRef = v),
+		),
+	});
+
+	const itemsState = CommandGroupItemsState.create({
+		id: boxWith(() => itemsId),
+		ref: boxWith(
+			() => itemsRef,
+			(v) => (itemsRef = v),
+		),
+	});
+
+	const mergedProps = $derived(
+		mergeProps({ 'data-slot': 'command-group', class: 'text-foreground overflow-hidden p-1' }, restProps, groupState.props),
+	);
+
+	const headingProps = $derived(mergeProps({ class: 'text-muted-foreground px-2 py-1.5 text-xs font-medium' }, headingState.props));
+</script>
+
+{#if child}
+	{@render child({ props: mergedProps })}
+{:else}
+	<div {...mergedProps}>
+		{#if heading}
+			<div {...headingProps}>
+				{heading}
+			</div>
+		{/if}
+		<div class="contents">
+			<div {...itemsState.props}>
+				{@render children?.()}
+			</div>
+		</div>
+	</div>
+{/if}

package/src/lib/components/command/components/command-input.svelte

@@ -0,0 +1,55 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandInputProps } from '../types.js';
+	import { CommandInputState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+	import SearchIcon from '@lucide/svelte/icons/search';
+
+	const uid = $props.id();
+
+	let {
+		value = $bindable(''),
+		autofocus = false,
+		id = createId(uid),
+		ref = $bindable(null),
+		child,
+		...restProps
+	}: CommandInputProps = $props();
+
+	const inputState = CommandInputState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		value: boxWith(
+			() => value,
+			(v) => {
+				value = v;
+			},
+		),
+		autofocus: boxWith(() => autofocus ?? false),
+	});
+
+	const mergedProps = $derived(
+		mergeProps(
+			{
+				'data-slot': 'command-input',
+				class:
+					'placeholder:text-muted-foreground flex h-10 w-full rounded-md bg-transparent py-3 text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50',
+			},
+			restProps,
+			inputState.props,
+		),
+	);
+</script>
+
+<div class="flex h-9 items-center gap-2 border-b ps-3 pe-8" data-slot="command-input-wrapper">
+	<SearchIcon class="size-4 shrink-0 opacity-50" />
+	{#if child}
+		{@render child({ props: mergedProps })}
+	{:else}
+		<input {...mergedProps} bind:value />
+	{/if}
+</div>

package/src/lib/components/command/components/command-item.svelte

@@ -0,0 +1,61 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandItemProps } from '../types.js';
+	import { CommandItemState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let {
+		id = createId(uid),
+		ref = $bindable(null),
+		value = '',
+		disabled = false,
+		children,
+		child,
+		onSelect = () => {},
+		forceMount = false,
+		keywords = [],
+		...restProps
+	}: CommandItemProps = $props();
+
+	const itemState = CommandItemState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		value: boxWith(() => value),
+		disabled: boxWith(() => disabled),
+		onSelect: boxWith(() => onSelect),
+		forceMount: boxWith(() => forceMount),
+		keywords: boxWith(() => keywords),
+	});
+
+	const mergedProps = $derived(
+		mergeProps(
+			{
+				'data-slot': 'command-item',
+				class:
+					"aria-selected:bg-accent aria-selected:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-md px-2 py-1.5 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+			},
+			restProps,
+			itemState.props,
+		),
+	);
+</script>
+
+{#key itemState.root.key}
+	<div class="contents" data-item-wrapper data-value={itemState.trueValue}>
+		{#if itemState.shouldRender}
+			{#if child}
+				{@render child({ props: mergedProps })}
+			{:else}
+				<div {...mergedProps}>
+					{@render children?.()}
+				</div>
+			{/if}
+		{/if}
+	</div>
+{/key}

package/src/lib/components/command/components/command-link-item.svelte

@@ -0,0 +1,61 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandLinkItemProps } from '../types.js';
+	import { CommandItemState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let {
+		id = createId(uid),
+		ref = $bindable(null),
+		value = '',
+		disabled = false,
+		children,
+		child,
+		onSelect = () => {},
+		forceMount = false,
+		keywords = [],
+		...restProps
+	}: CommandLinkItemProps = $props();
+
+	const itemState = CommandItemState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		value: boxWith(() => value),
+		disabled: boxWith(() => disabled),
+		onSelect: boxWith(() => onSelect),
+		forceMount: boxWith(() => forceMount),
+		keywords: boxWith(() => keywords),
+	});
+
+	const mergedProps = $derived(
+		mergeProps(
+			{
+				'data-slot': 'command-item',
+				class:
+					"aria-selected:bg-accent aria-selected:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-md px-2 py-1.5 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+			},
+			restProps,
+			itemState.props,
+		),
+	);
+</script>
+
+{#key itemState.root.key}
+	<div class="contents">
+		{#if itemState.shouldRender}
+			{#if child}
+				{@render child({ props: mergedProps })}
+			{:else}
+				<a {...mergedProps}>
+					{@render children?.()}
+				</a>
+			{/if}
+		{/if}
+	</div>
+{/key}

package/src/lib/components/command/components/command-list.svelte

@@ -0,0 +1,41 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandListProps } from '../types.js';
+	import { CommandListState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), child, children, 'aria-label': ariaLabel, ...restProps }: CommandListProps = $props();
+
+	const listState = CommandListState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		ariaLabel: boxWith(() => ariaLabel ?? 'Suggestions...'),
+	});
+
+	const mergedProps = $derived(
+		mergeProps(
+			{
+				'data-slot': 'command-list',
+				class: 'max-h-75 scroll-py-1 overflow-x-hidden overflow-y-auto',
+			},
+			restProps,
+			listState.props,
+		),
+	);
+</script>
+
+{#key listState.root._commandState.search === ''}
+	{#if child}
+		{@render child({ props: mergedProps })}
+	{:else}
+		<div {...mergedProps}>
+			{@render children?.()}
+		</div>
+	{/if}
+{/key}

package/src/lib/components/command/components/command-loading.svelte

@@ -0,0 +1,30 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandLoadingProps } from '../types.js';
+	import { CommandLoadingState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { progress = 0, id = createId(uid), ref = $bindable(null), children, child, ...restProps }: CommandLoadingProps = $props();
+
+	const loadingState = CommandLoadingState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		progress: boxWith(() => progress),
+	});
+
+	const mergedProps = $derived(mergeProps(restProps, loadingState.props));
+</script>
+
+{#if child}
+	{@render child({ props: mergedProps })}
+{:else}
+	<div {...mergedProps}>
+		{@render children?.()}
+	</div>
+{/if}

package/src/lib/components/command/components/command-separator.svelte

@@ -0,0 +1,34 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import type { CommandSeparatorProps } from '../types.js';
+	import { CommandSeparatorState } from '../command.svelte.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), forceMount = false, children, child, ...restProps }: CommandSeparatorProps = $props();
+
+	const separatorState = CommandSeparatorState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+		forceMount: boxWith(() => forceMount),
+	});
+
+	const mergedProps = $derived(
+		mergeProps({ 'data-slot': 'command-separator', class: 'bg-border -mx-1 h-px' }, restProps, separatorState.props),
+	);
+</script>
+
+{#if separatorState.shouldRender}
+	{#if child}
+		{@render child({ props: mergedProps })}
+	{:else}
+		<div {...mergedProps}>
+			{@render children?.()}
+		</div>
+	{/if}
+{/if}

package/src/lib/components/command/components/command-viewport.svelte

@@ -0,0 +1,29 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import { CommandViewportState } from '../command.svelte.js';
+	import type { CommandViewportProps } from '../types.js';
+	import { createId } from '../../../internal/create-id.js';
+
+	const uid = $props.id();
+
+	let { id = createId(uid), ref = $bindable(null), children, child, ...restProps }: CommandViewportProps = $props();
+
+	const listViewportState = CommandViewportState.create({
+		id: boxWith(() => id),
+		ref: boxWith(
+			() => ref,
+			(v) => (ref = v),
+		),
+	});
+
+	const mergedProps = $derived(mergeProps(restProps, listViewportState.props));
+</script>
+
+{#if child}
+	{@render child({ props: mergedProps })}
+{:else}
+	<div {...mergedProps}>
+		{@render children?.()}
+	</div>
+{/if}

package/src/lib/components/command/components/command.svelte

@@ -0,0 +1,143 @@
+<script lang="ts">
+	import { boxWith } from '../../../internal/tools/index.js';
+	import { mergeProps } from '../../../internal/merge-props.js';
+	import { CommandRootState } from '../command.svelte.js';
+	import type { CommandRootProps } from '../types.js';
+	import CommandLabel from './_command-label.svelte';
+	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 = () => {},
+		onStateChange = () => {},
+		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(
+			{
+				'data-slot': 'command',
+				class: 'bg-popover text-popover-foreground flex h-full w-full flex-col overflow-hidden rounded-md',
+			},
+			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}