svelora 2.1.0

package/dist/RadioGroup/RadioGroup.svelte

@@ -0,0 +1,226 @@
+<script lang="ts" module>
+    import type { RadioGroupProps } from './radio-group.types.js'
+
+    export type Props = RadioGroupProps
+</script>
+
+<script lang="ts">
+    import { Label, RadioGroup, useId } from 'bits-ui'
+    import { getComponentConfig, iconsDefaults } from '../config.js'
+    import { useFormField, useFormFieldEmit } from '../hooks/useFormField.svelte.js'
+    import Icon from '../Icon/Icon.svelte'
+    import type { RadioGroupItem } from './radio-group.types.js'
+    import { radioGroupDefaults, radioGroupVariants } from './radio-group.variants.js'
+
+    const config = getComponentConfig('radioGroup', radioGroupDefaults)
+    const icons = getComponentConfig('icons', iconsDefaults)
+
+    let {
+        ref = $bindable(null),
+        value = $bindable(''),
+        onValueChange,
+        items = [],
+        ui,
+        id,
+        name,
+        color = config.defaultVariants.color,
+        size,
+        variant = config.defaultVariants.variant,
+        indicator = config.defaultVariants.indicator,
+        orientation = config.defaultVariants.orientation,
+        disabled = false,
+        required = false,
+        readonly = false,
+        loop = true,
+        loading = false,
+        loadingIcon = icons.loading,
+        legend,
+        legendSlot,
+        labelSlot,
+        descriptionSlot,
+        class: className,
+        ...restProps
+    }: Props = $props()
+
+    const formFieldContext = useFormField()
+    const emit = useFormFieldEmit()
+
+    const hasError = $derived(
+        formFieldContext?.error !== undefined && formFieldContext?.error !== false
+    )
+    const resolvedSize = $derived(size ?? formFieldContext?.size ?? config.defaultVariants.size)
+    const resolvedColor = $derived(hasError ? 'error' : color)
+    const autoId = useId()
+    const resolvedId = $derived(id ?? formFieldContext?.ariaId ?? autoId)
+    const resolvedName = $derived(name ?? formFieldContext?.name)
+    const isDisabled = $derived(disabled || loading)
+    const legendId = $derived(`${resolvedId}-legend`)
+
+    const ariaDescribedBy = $derived(
+        !formFieldContext
+            ? undefined
+            : hasError
+              ? `${formFieldContext.ariaId}-error`
+              : `${formFieldContext.ariaId}-description ${formFieldContext.ariaId}-help`
+    )
+
+    const slots = $derived(
+        radioGroupVariants({
+            color: resolvedColor,
+            size: resolvedSize,
+            variant,
+            indicator,
+            orientation,
+            loading,
+            required,
+            disabled: isDisabled ? true : undefined
+        })
+    )
+
+    const layoutClasses = $derived.by(() => ({
+        root: slots.root({ class: [config.slots.root, className, ui?.root] }),
+        fieldset: slots.fieldset({ class: [config.slots.fieldset, ui?.fieldset] }),
+        legend: slots.legend({ class: [config.slots.legend, ui?.legend] }),
+        item: slots.item({ class: [config.slots.item, ui?.item] }),
+        container: slots.container({ class: [config.slots.container, ui?.container] }),
+        wrapper: slots.wrapper({ class: [config.slots.wrapper, ui?.wrapper] })
+    }))
+
+    const elementClasses = $derived.by(() => ({
+        base: slots.base({ class: [config.slots.base, ui?.base] }),
+        indicator: slots.indicator({ class: [config.slots.indicator, ui?.indicator] }),
+        loadingIcon: slots.loadingIcon({ class: [config.slots.loadingIcon, ui?.loadingIcon] }),
+        label: slots.label({ class: [config.slots.label, ui?.label] }),
+        description: slots.description({ class: [config.slots.description, ui?.description] })
+    }))
+
+    function handleCardItemClick(e: MouseEvent, btnId: string, itemDisabled: boolean) {
+        if (itemDisabled) return
+        if ((e.target as Element).closest('button')) return
+        document.getElementById(btnId)?.click()
+    }
+</script>
+
+{#snippet itemContent(radioItem: RadioGroupItem)}
+    {@const itemId = `${resolvedId}-${radioItem.value}`}
+    {@const itemDisabled = isDisabled || !!radioItem.disabled}
+    <div class={layoutClasses.container}>
+        <RadioGroup.Item
+            value={radioItem.value}
+            disabled={itemDisabled}
+            id={itemId}
+            class={elementClasses.base}
+        >
+            {#snippet children({ checked })}
+                {#if checked}
+                    <span class={elementClasses.indicator}>
+                        {#if loading}
+                            <Icon name={loadingIcon} class={elementClasses.loadingIcon} />
+                        {/if}
+                    </span>
+                {/if}
+            {/snippet}
+        </RadioGroup.Item>
+    </div>
+
+    {#if radioItem.label || radioItem.description || labelSlot || descriptionSlot}
+        <div class={layoutClasses.wrapper}>
+            {#if labelSlot}
+                {@render labelSlot({ item: radioItem })}
+            {:else if radioItem.label}
+                {#if variant === 'card'}
+                    <span
+                        class={[elementClasses.label, itemDisabled && 'cursor-not-allowed']
+                            .filter(Boolean)
+                            .join(' ')}>{radioItem.label}</span
+                    >
+                {:else}
+                    <Label.Root
+                        for={itemId}
+                        class={[elementClasses.label, itemDisabled && 'cursor-not-allowed']
+                            .filter(Boolean)
+                            .join(' ')}
+                    >
+                        {radioItem.label}
+                    </Label.Root>
+                {/if}
+            {/if}
+
+            {#if descriptionSlot}
+                {@render descriptionSlot({ item: radioItem })}
+            {:else if radioItem.description}
+                <p
+                    class={[elementClasses.description, itemDisabled && 'cursor-not-allowed']
+                        .filter(Boolean)
+                        .join(' ')}
+                >
+                    {radioItem.description}
+                </p>
+            {/if}
+        </div>
+    {/if}
+{/snippet}
+
+<div
+    {...restProps}
+    bind:this={ref}
+    class={layoutClasses.root}
+    onfocusin={() => emit.onFocus()}
+    onfocusout={(e) => {
+        if (!e.currentTarget.contains(e.relatedTarget as Node | null)) {
+            emit.onBlur()
+        }
+    }}
+>
+    <RadioGroup.Root
+        bind:value
+        onValueChange={(val) => {
+            emit.onChange()
+            onValueChange?.(val)
+        }}
+        id={resolvedId}
+        name={resolvedName}
+        disabled={isDisabled}
+        {required}
+        {readonly}
+        {loop}
+        {orientation}
+        aria-describedby={ariaDescribedBy}
+        aria-invalid={hasError ? true : undefined}
+        aria-labelledby={legend && !legendSlot ? legendId : undefined}
+        class={layoutClasses.fieldset}
+    >
+        {#if legend || legendSlot}
+            {#if legendSlot}
+                {@render legendSlot({ legend })}
+            {:else}
+                <span id={legendId} class={layoutClasses.legend}>{legend}</span>
+            {/if}
+        {/if}
+
+        {#each items as radioItem (radioItem.value)}
+            {#if variant === 'card'}
+                <div
+                    role="none"
+                    class={layoutClasses.item}
+                    class:opacity-75={radioItem.disabled && !isDisabled}
+                    onclick={(e) =>
+                        handleCardItemClick(
+                            e,
+                            `${resolvedId}-${radioItem.value}`,
+                            isDisabled || !!radioItem.disabled
+                        )}
+                >
+                    {@render itemContent(radioItem)}
+                </div>
+            {:else}
+                <div
+                    class={layoutClasses.item}
+                    class:opacity-75={radioItem.disabled && !isDisabled}
+                >
+                    {@render itemContent(radioItem)}
+                </div>
+            {/if}
+        {/each}
+    </RadioGroup.Root>
+</div>

package/dist/RadioGroup/RadioGroup.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { RadioGroupProps } from './radio-group.types.js';
+export type Props = RadioGroupProps;
+import { RadioGroup } from 'bits-ui';
+declare const RadioGroup: import("svelte").Component<RadioGroupProps, {}, "value" | "ref">;
+type RadioGroup = ReturnType<typeof RadioGroup>;
+export default RadioGroup;

package/dist/RadioGroup/index.d.ts

@@ -0,0 +1,2 @@
+export { default as RadioGroup } from './RadioGroup.svelte';
+export type { RadioGroupItem, RadioGroupProps } from './radio-group.types.js';

package/dist/RadioGroup/index.js

@@ -0,0 +1 @@
+export { default as RadioGroup } from './RadioGroup.svelte';

package/dist/RadioGroup/radio-group.types.d.ts

@@ -0,0 +1,111 @@
+import type { RadioGroup as RadioGroupPrimitive } from 'bits-ui';
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import type { ClassNameValue } from 'tailwind-merge';
+import type { RadioGroupSlots, RadioGroupVariantProps } from './radio-group.variants.js';
+export type RadioGroupItem = {
+    /**
+     * The unique value for this radio item.
+     */
+    value: string;
+    /**
+     * Label text displayed next to the radio.
+     */
+    label?: string;
+    /**
+     * Description text displayed below the label.
+     */
+    description?: string;
+    /**
+     * Whether this individual radio item is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+};
+export type RadioGroupProps = Pick<RadioGroupPrimitive.RootProps, 'disabled' | 'name' | 'required' | 'loop' | 'readonly'> & Omit<HTMLAttributes<HTMLElement>, 'class'> & {
+    /**
+     * Bindable reference to the root DOM element.
+     */
+    ref?: HTMLElement | null;
+    /**
+     * The selected value. Supports two-way binding with `bind:value`.
+     */
+    value?: string;
+    /**
+     * Callback when the value changes.
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * The list of radio items to render.
+     */
+    items?: RadioGroupItem[];
+    /**
+     * Sets the color scheme for the radio indicators.
+     * @default 'primary'
+     */
+    color?: NonNullable<RadioGroupVariantProps['color']>;
+    /**
+     * Controls the dimensions of the radio group.
+     * @default 'md'
+     */
+    size?: NonNullable<RadioGroupVariantProps['size']>;
+    /**
+     * Controls the visual style of each radio item.
+     * @default 'list'
+     */
+    variant?: NonNullable<RadioGroupVariantProps['variant']>;
+    /**
+     * Controls the position of the radio indicator.
+     * @default 'start'
+     */
+    indicator?: NonNullable<RadioGroupVariantProps['indicator']>;
+    /**
+     * Controls the layout direction.
+     * @default 'vertical'
+     */
+    orientation?: NonNullable<RadioGroupVariantProps['orientation']>;
+    /**
+     * Legend text displayed above the radio group.
+     */
+    legend?: string;
+    /**
+     * Renders a loading spinner and disables interaction.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Icon displayed as the loading indicator.
+     * @default Uses `icons.loading` from app config
+     */
+    loadingIcon?: string;
+    /**
+     * The HTML id attribute for the radio group.
+     */
+    id?: string;
+    /**
+     * Custom snippet for the legend.
+     */
+    legendSlot?: Snippet<[{
+        legend?: string;
+    }]>;
+    /**
+     * Custom snippet for each item's label.
+     */
+    labelSlot?: Snippet<[{
+        item: RadioGroupItem;
+    }]>;
+    /**
+     * Custom snippet for each item's description.
+     */
+    descriptionSlot?: Snippet<[{
+        item: RadioGroupItem;
+    }]>;
+    /**
+     * Additional CSS classes for the root element.
+     */
+    class?: ClassNameValue;
+    /**
+     * Override styles for specific radio group slots.
+     */
+    ui?: Partial<Record<RadioGroupSlots, ClassNameValue>>;
+};

package/dist/RadioGroup/radio-group.types.js

@@ -0,0 +1 @@
+export {};