@sveltia/ui 0.16.0 → 0.17.1

package/package/components/radio/radio.svelte.d.ts

@@ -1,26 +1,8 @@
 export default Radio;
-type Radio = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    name?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    checked?: boolean | undefined;
-    value?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
-    focus: FocusEvent;
-    blur: FocusEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+type Radio = SvelteComponent<Props & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "" | undefined;
 };
 /**
  * The equivalent of the HTML `<input type="radio">` element.
@@ -28,32 +10,104 @@ type Radio = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
  * @see https://w3c.github.io/aria/#radio
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/radio/
  */
-declare const Radio: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
+declare const Radio: $$__sveltets_2_IsomorphicComponent<{
+    /**
+     * - The `class` attribute on the wrapper element.
+     */
     class?: string | undefined;
-    name?: string | undefined;
+    /**
+     * - Whether to hide the widget.
+     */
+    hidden?: boolean | undefined;
+    /**
+     * - Whether to disable the widget. An alias of the `aria-disabled`
+     * attribute.
+     */
     disabled?: boolean | undefined;
-    label?: string | undefined;
+    /**
+     * - Whether to check the widget. An alias of the `aria-checked`
+     * attribute.
+     */
     checked?: boolean | undefined;
+    /**
+     * - The `name` attribute on the `<button>` element.
+     */
+    name?: string | undefined;
+    /**
+     * - The `value` attribute on the `<button>` element.
+     */
     value?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
-    focus: FocusEvent;
-    blur: FocusEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+    /**
+     * - Text label displayed next to the checkbox.
+     */
+    label?: string | undefined;
+    /**
+     * - Primary slot content.
+     */
+    children?: import("svelte").Snippet<[]> | undefined;
+    /**
+     * - Default slot content.
+     */
+    default?: import("svelte").Snippet<[]> | undefined;
+    /**
+     * - Custom `Change` event handler.
+     */
+    onChange?: ((event: CustomEvent) => void) | undefined;
+    /**
+     * - Custom `Select` event handler.
+     */
+    onSelect?: ((event: CustomEvent) => void) | undefined;
+} & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}, {}, string>;
-type $$__sveltets_2_PropsWithChildren<Props, Slots> = Props & (Slots extends {
-    default: any;
-} ? Props extends Record<string, never> ? any : {
-    children?: any;
-} : {});
+}, {}, {}, "">;
+type Props = {
+    /**
+     * - The `class` attribute on the wrapper element.
+     */
+    class?: string | undefined;
+    /**
+     * - Whether to hide the widget.
+     */
+    hidden?: boolean | undefined;
+    /**
+     * - Whether to disable the widget. An alias of the `aria-disabled`
+     * attribute.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * - Whether to check the widget. An alias of the `aria-checked`
+     * attribute.
+     */
+    checked?: boolean | undefined;
+    /**
+     * - The `name` attribute on the `<button>` element.
+     */
+    name?: string | undefined;
+    /**
+     * - The `value` attribute on the `<button>` element.
+     */
+    value?: string | undefined;
+    /**
+     * - Text label displayed next to the checkbox.
+     */
+    label?: string | undefined;
+    /**
+     * - Primary slot content.
+     */
+    children?: import("svelte").Snippet<[]> | undefined;
+    /**
+     * - Default slot content.
+     */
+    default?: import("svelte").Snippet<[]> | undefined;
+    /**
+     * - Custom `Change` event handler.
+     */
+    onChange?: ((event: CustomEvent) => void) | undefined;
+    /**
+     * - Custom `Select` event handler.
+     */
+    onSelect?: ((event: CustomEvent) => void) | undefined;
+};
 interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
     new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
         $$bindings?: Bindings;

package/package/components/select/combobox.svelte

@@ -7,9 +7,7 @@
 -->
 <script>
   import { generateElementId } from '@sveltia/utils/element';
-  import { createEventDispatcher } from 'svelte';
   import { _ } from 'svelte-i18n';
-  import { writable } from 'svelte/store';
   import Button from '../button/button.svelte';
   import Icon from '../icon/icon.svelte';
   import Listbox from '../listbox/listbox.svelte';
@@ -18,78 +16,56 @@
   import Popup from '../util/popup.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @type {import('../../typedefs').ComboboxProps & import('../../typedefs').TextInputProps &
+   * Record<string, any>}
    */
-  let className = '';
-  export { className as class };
-  /**
-   * Whether to hide the widget. An alias of the `aria-hidden` attribute.
-   * @type {boolean | undefined}
-   */
-  export let hidden = undefined;
-  /**
-   * Whether to disable the widget. An alias of the `aria-disabled` attribute.
-   * @type {boolean}
-   */
-  export let disabled = false;
-  /**
-   * Whether to make the widget read-only. An alias of the `aria-readonly` attribute.
-   * @type {boolean}
-   */
-  export let readonly = false;
-  /**
-   * Whether to mark the widget required. An alias of the `aria-required` attribute.
-   * @type {boolean}
-   */
-  export let required = false;
-  /**
-   * Whether to mark the widget invalid. An alias of the `aria-invalid` attribute.
-   * @type {boolean}
-   */
-  export let invalid = false;
-  /**
-   * Selected option’s value.
-   * @type {(string | number | undefined)}
-   */
-  export let value = undefined;
-  /**
-   * Whether to make the `combobox` editable.
-   */
-  export let editable = true;
-  /**
-   * Where to show the dropdown menu.
-   * @type {import('../../typedefs').PopupPosition}
-   */
-  export let position = 'bottom-left';
+  let {
+    /* eslint-disable prefer-const */
+    value = $bindable(),
+    class: className,
+    hidden = false,
+    disabled = false,
+    readonly = false,
+    required = false,
+    invalid = false,
+    editable = true,
+    position = 'bottom-left',
+    children,
+    chevronIcon,
+    onChange,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 
-  const dispatch = createEventDispatcher();
   const id = generateElementId('combobox');
   const selectedSelector = '[role="option"][aria-selected="true"]';
-  /** @type {HTMLElement} */
-  let comboboxElement;
-  /** @type {TextInput | undefined} */
-  let inputComponent;
-  /** @type {Popup | undefined} */
-  let popupComponent;
-  let isPopupOpen = writable(false);
+  let isPopupOpen = $state(false);
+
+  /** @type {HTMLElement | undefined} */
+  let comboboxElement = $state();
+  /** @type {HTMLInputElement | undefined} */
+  let inputElement = $state();
+  /** @type {HTMLElement | undefined} */
+  let popupContent = $state();
   /** @type {string} */
-  let label = '';
+  let label = $state('');
   /** @type {boolean} */
-  let showFilter = false;
+  let showFilter = $state(false);
   /** @type {string} */
-  let searchTerms = '';
+  let searchTerms = $state('');
   /** @type {boolean} */
-  let hasMatchingOptions = true;
+  let hasMatchingOptions = $state(true);
+  /** @type {HTMLElement} */
+  const anchor = $derived(/** @type {HTMLElement} */ (comboboxElement ?? inputElement));
 
   /**
    * Update the {@link label} and selected option when the {@link value} is changed.
    */
-  const onChange = () => {
-    const selected = popupComponent?.content?.querySelector(selectedSelector);
+  const _onChange = () => {
+    const selected = popupContent?.querySelector(selectedSelector);
 
     const target = /** @type {HTMLButtonElement} */ (
-      popupComponent?.content?.querySelector(`[role="option"][value="${value}"]`)
+      popupContent?.querySelector(`[role="option"][value="${value}"]`)
     );
 
     if (target) {
@@ -106,53 +82,48 @@
    * Update the {@link value} whenever an option is selected.
    * @param {HTMLButtonElement} target - Selected option.
    */
-  const onSelect = (target) => {
+  const _onSelect = (target) => {
     // @todo support more types
+    // @ts-ignore
     value = target.dataset.type === 'number' ? Number(target.value) : target.value;
-    onChange();
-    dispatch('change', { target: inputComponent?.element, value });
+    _onChange();
+    onChange?.(new CustomEvent('Change', { detail: { target: inputElement, value } }));
   };
 
-  $: {
-    if (popupComponent?.content) {
+  $effect(() => {
+    if (popupContent) {
       globalThis.requestAnimationFrame(() => {
-        const selected = popupComponent?.content?.querySelector(selectedSelector);
+        const selected = popupContent?.querySelector(selectedSelector);
 
         if (selected) {
-          onSelect(/** @type {HTMLButtonElement} */ (selected));
+          _onSelect(/** @type {HTMLButtonElement} */ (selected));
         }
       });
     }
-  }
+  });
 
-  $: {
+  $effect(() => {
     void value;
-    onChange();
-  }
+    _onChange();
+  });
 </script>
 
-<div
-  role="none"
-  class="sui combobox {className}"
-  class:editable
-  hidden={hidden || undefined}
-  {...$$restProps}
->
+<div {...restProps} role="none" class="sui combobox {className}" class:editable {hidden}>
   {#if !editable}
     <div
+      bind:this={comboboxElement}
+      {...restProps}
       role="combobox"
       {id}
       class:selected={value !== undefined}
       tabindex={disabled ? -1 : 0}
       aria-controls="{id}-popup"
-      aria-expanded={$isPopupOpen}
+      aria-expanded={isPopupOpen}
       aria-hidden={hidden}
       aria-disabled={disabled}
       aria-readonly={readonly}
       aria-haspopup="listbox"
       aria-activedescendant="selected-option"
-      {...$$restProps}
-      bind:this={comboboxElement}
     >
       <div role="none" class="label">
         {value !== undefined ? label : $_('_sui.combobox.select_an_option')}
@@ -160,6 +131,8 @@
     </div>
   {:else}
     <TextInput
+      {...restProps}
+      bind:element={inputElement}
       role="combobox"
       {id}
       {value}
@@ -169,11 +142,9 @@
       {required}
       {invalid}
       aria-controls="{id}-popup"
-      aria-expanded={$isPopupOpen}
+      aria-expanded={isPopupOpen}
       aria-haspopup="listbox"
       aria-activedescendant="selected-option"
-      {...$$restProps}
-      bind:this={inputComponent}
     />
   {/if}
   <Button
@@ -182,33 +153,37 @@
     {hidden}
     {disabled}
     tabindex={readonly || disabled ? -1 : 0}
-    aria-label={$isPopupOpen ? $_('_sui.collapse') : $_('_sui.expand')}
+    aria-label={isPopupOpen ? $_('_sui.collapse') : $_('_sui.expand')}
     aria-controls="{id}-popup"
-    aria-expanded={$isPopupOpen}
-    on:click={(event) => {
+    aria-expanded={isPopupOpen}
+    onclick={(event) => {
       event.preventDefault();
       event.stopPropagation();
 
       if (!disabled && !readonly) {
-        $isPopupOpen = !$isPopupOpen;
+        isPopupOpen = !isPopupOpen;
       }
     }}
   >
-    <slot name="chevron-icon" slot="start-icon">
-      <Icon name="expand_more" />
-    </slot>
+    {#snippet startIcon()}
+      {#if chevronIcon}
+        {@render chevronIcon()}
+      {:else}
+        <Icon name="expand_more" />
+      {/if}
+    {/snippet}
   </Button>
 </div>
 <Popup
+  bind:content={popupContent}
   id="{id}-popup"
   class="combobox"
-  anchor={comboboxElement ?? inputComponent?.element}
+  {anchor}
   {position}
   touchOptimized={true}
   bind:open={isPopupOpen}
-  bind:this={popupComponent}
-  on:open={() => {
-    showFilter = (popupComponent?.content?.querySelectorAll('[role="option"]')?.length ?? 0) > 5;
+  onopen={() => {
+    showFilter = (popupContent?.querySelectorAll('[role="option"]')?.length ?? 0) > 5;
     searchTerms = '';
   }}
 >
@@ -219,10 +194,10 @@
         aria-label={$_('_sui.combobox.filter_options')}
         aria-controls="{id}-listbox"
         bind:value={searchTerms}
-        on:keydown={(event) => {
+        onkeydown={(event) => {
           if (['ArrowUp', 'ArrowDown', 'Enter'].includes(event.key)) {
             event.preventDefault();
-            popupComponent?.content
+            popupContent
               ?.querySelector('.sui.listbox')
               ?.dispatchEvent(new KeyboardEvent('keydown', event));
           }
@@ -233,16 +208,16 @@
       id="{id}-listbox"
       class="in-combobox"
       {searchTerms}
-      on:click={(event) => {
+      onclick={(event) => {
         if (/** @type {HTMLElement} */ (event.target).matches('[role="option"]')) {
-          onSelect(/** @type {HTMLButtonElement} */ (event.target));
+          _onSelect(/** @type {HTMLButtonElement} */ (event.target));
         }
       }}
-      on:filter={(event) => {
+      onFilter={(event) => {
         hasMatchingOptions = !!(/** @type {CustomEvent} */ (event).detail.matched);
       }}
     >
-      <slot />
+      {@render children?.()}
     </Listbox>
     {#if !hasMatchingOptions}
       <div role="alert" class="no-options">

package/package/components/select/combobox.svelte.d.ts

@@ -1,31 +1,8 @@
 export default Combobox;
-type Combobox = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    invalid?: boolean | undefined;
-    required?: boolean | undefined;
-    value?: string | number | undefined;
-    position?: PopupPosition | undefined;
-    hidden?: boolean | undefined;
-    readonly?: boolean | undefined;
-    editable?: boolean | undefined;
-}, {
-    'chevron-icon': {
-        slot: string;
-    };
-    default: {};
-}>, {
-    change: CustomEvent<any>;
-} & {
+type Combobox = SvelteComponent<ComboboxProps & TextInputProps & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'chevron-icon': {
-        slot: string;
-    };
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "value" | undefined;
 };
 /**
  * A variant of the `<Select>` widget with an auto-complete text input field.
@@ -33,37 +10,9 @@ type Combobox = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
  * @todo Add DOM API compatibility.
  */
-declare const Combobox: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    invalid?: boolean | undefined;
-    required?: boolean | undefined;
-    value?: (string | number | undefined);
-    position?: import("../../typedefs").PopupPosition | undefined;
-    hidden?: boolean | undefined;
-    readonly?: boolean | undefined;
-    editable?: boolean | undefined;
-}, {
-    'chevron-icon': {
-        slot: string;
-    };
-    default: {};
-}>, {
-    change: CustomEvent<any>;
-} & {
+declare const Combobox: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").ComboboxProps & import("../../typedefs").TextInputProps & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'chevron-icon': {
-        slot: string;
-    };
-    default: {};
-}, {}, string>;
-type $$__sveltets_2_PropsWithChildren<Props, Slots> = Props & (Slots extends {
-    default: any;
-} ? Props extends Record<string, never> ? any : {
-    children?: any;
-} : {});
+}, {}, {}, "value">;
 interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
     new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
         $$bindings?: Bindings;

package/package/components/select/select-tags.svelte

@@ -1,5 +1,4 @@
 <script>
-  import { createEventDispatcher } from 'svelte';
   import { _ } from 'svelte-i18n';
   import Button from '../button/button.svelte';
   import Icon from '../icon/icon.svelte';
@@ -7,66 +6,54 @@
   import Select from './select.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @typedef {object} Props
+   * @property {{ label: string, value: string, searchValue?: string }[]} options - Available
+   * options.
+   * @property {string[]} [values] - Selected option values.
+   * @property {number | undefined} [max] - Maximum number of selectable options.
+   * @property {string} [class] - The `class` attribute on the wrapper element.
+   * @property {boolean} [hidden] - Whether to hide the widget.
+   * @property {boolean} [disabled] - Whether to disable the widget. An alias of the `aria-disabled`
+   * attribute.
+   * @property {boolean} [readonly] - Whether to make the widget read-only. An alias of the
+   * `aria-readonly` attribute.
+   * @property {boolean} [required] - Whether to mark the widget required. An alias of the
+   * `aria-required` attribute.
+   * @property {boolean} [invalid] - Whether to mark the widget invalid. An alias of the
+   * `aria-invalid` attribute.
+   * @property {import('svelte').Snippet} [children] - Primary slot content.
+   * @property {(event: CustomEvent) => void} [onAddValue] - Custom `AddValue` event handler.
+   * @property {(event: CustomEvent) => void} [onRemoveValue] - Custom `RemoveValue` event handler.
    */
-  let className = '';
-  export { className as class };
-  /**
-   * Whether to hide the widget. An alias of the `aria-hidden` attribute.
-   * @type {boolean | undefined}
-   */
-  export let hidden = undefined;
-  /**
-   * Whether to disable the widget. An alias of the `aria-disabled` attribute.
-   * @type {boolean}
-   */
-  export let disabled = false;
-  /**
-   * Whether to make the widget read-only. An alias of the `aria-readonly` attribute.
-   * @type {boolean}
-   */
-  export let readonly = false;
-  /**
-   * Whether to mark the widget required. An alias of the `aria-required` attribute.
-   * @type {boolean}
-   */
-  export let required = false;
-  /**
-   * Whether to mark the widget invalid. An alias of the `aria-invalid` attribute.
-   * @type {boolean}
-   */
-  export let invalid = false;
-  /**
-   * Available options.
-   * @type {{ label: string, value: string, searchValue?: string }[]}
-   */
-  export let options;
-  /**
-   * Selected option values.
-   * @type {string[]}
-   */
-  export let values = [];
+
   /**
-   * Maximum number of selectable options.
-   * @type {number | undefined}
+   * @type {Props & Record<string, any>}
    */
-  export let max = undefined;
+  let {
+    /* eslint-disable prefer-const */
+    values = $bindable([]),
+    options,
+    max = undefined,
+    class: className,
+    hidden = false,
+    disabled = false,
+    readonly = false,
+    required = false,
+    invalid = false,
+    children,
+    onAddValue,
+    onRemoveValue,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 
   /**
    * @type {string | undefined}
    */
-  let selectedValue = undefined;
-
-  const dispatch = createEventDispatcher();
+  let selectedValue = $state();
 </script>
 
-<div
-  role="none"
-  class="sui select-tags {className}"
-  class:disabled={disabled || readonly}
-  hidden={hidden || undefined}
->
+<div role="none" class="sui select-tags {className}" class:disabled={disabled || readonly} {hidden}>
   {#each values as value}
     {@const option = options.find((o) => o.value === value)}
     {#if option}
@@ -77,28 +64,30 @@
           size="small"
           disabled={disabled || readonly}
           aria-label={$_('remove_x', { values: { name: option.label } })}
-          on:click={() => {
+          onclick={() => {
             values = values.filter((v) => v !== value);
-            dispatch('RemoveValue', { value });
+            onRemoveValue?.(new CustomEvent('RemoveValue', { detail: { value } }));
           }}
         >
-          <Icon slot="start-icon" name="close" />
+          {#snippet startIcon()}
+            <Icon name="close" />
+          {/snippet}
         </Button>
       </span>
     {/if}
   {/each}
   {#if (typeof max !== 'number' || values.length < max) && values.length < options.length}
     <Select
+      {...restProps}
+      bind:value={selectedValue}
       disabled={disabled || readonly}
       {readonly}
       {required}
       {invalid}
-      {...$$restProps}
-      bind:value={selectedValue}
-      on:change={() => {
+      onChange={() => {
         if (selectedValue) {
           values = [...values, selectedValue];
-          dispatch('AddValue', { value: selectedValue });
+          onAddValue?.(new CustomEvent('AddValue', { detail: { value: selectedValue } }));
           // Reset the combobox
           selectedValue = undefined;
         }