@sveltia/ui 0.16.0 → 0.17.0

package/package/components/listbox/option-group.svelte.d.ts

@@ -1,18 +1,8 @@
 export default OptionGroup;
-type OptionGroup = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
+type OptionGroup = SvelteComponent<Props & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "" | undefined;
 };
 /**
  * A group within a `<Listbox>`. The equivalent of the HTML `<optgroup>` element. It can contain one
@@ -21,24 +11,56 @@ type OptionGroup = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
  * @see https://w3c.github.io/aria/#listbox
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/listbox/examples/listbox-grouped/
  */
-declare const OptionGroup: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
+declare const OptionGroup: $$__sveltets_2_IsomorphicComponent<{
+    /**
+     * - The `class` attribute on the wrapper element.
+     */
     class?: string | undefined;
+    /**
+     * - Whether to hide the widget. An alias of the `aria-hidden`
+     * attribute.
+     */
+    hidden?: boolean | undefined;
+    /**
+     * - Whether to disable the widget. An alias of the `aria-disabled`
+     * attribute.
+     */
     disabled?: boolean | undefined;
+    /**
+     * - The group’s label to be displayed above the child `<Option>`s.
+     */
     label?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
+    /**
+     * - Primary slot content.
+     */
+    children?: import("svelte").Snippet<[]> | 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. An alias of the `aria-hidden`
+     * attribute.
+     */
+    hidden?: boolean | undefined;
+    /**
+     * - Whether to disable the widget. An alias of the `aria-disabled`
+     * attribute.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * - The group’s label to be displayed above the child `<Option>`s.
+     */
+    label?: string | undefined;
+    /**
+     * - Primary slot content.
+     */
+    children?: import("svelte").Snippet<[]> | 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/listbox/option.svelte

@@ -9,50 +9,43 @@
   import Icon from '../icon/icon.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @typedef {object} Props
+   * @property {string} [class] - The `class` attribute on the wrapper element.
+   * @property {boolean} [selected] - Whether to select the widget. An alias of the `aria-selected`
+   * attribute.
+   * @property {string} label - Text label displayed on the item.
+   * @property {string} [searchValue] - The value to be searched.
+   * @property {boolean} [wrap] - Whether to wrap a long label.
+   * @property {import('svelte').Snippet} [checkIcon] - Check icon slot content.
    */
-  let className = '';
-  export { className as class };
-  /**
-   * Whether to select the widget. An alias of the `aria-selected` attribute.
-   * @type {boolean}
-   */
-  export let selected = false;
-  /**
-   * 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;
-  /**
-   * Text label displayed on the item.
-   * @type {string}
-   */
-  export let label;
-  /**
-   * The `value` attribute on the `<button>` element.
-   * @type {string}
-   */
-  export let value = label;
-  /**
-   * The value to be searched.
-   * @type {string}
-   */
-  export let searchValue = label;
+
   /**
-   * Whether to wrap a long label.
-   * @type {boolean}
+   * @type {import('../../typedefs').ButtonProps & import('../../typedefs').CommonEventHandlers &
+   * Props & Record<string, any>}
    */
-  export let wrap = false;
+  let {
+    /* eslint-disable prefer-const */
+    selected = $bindable(false),
+    hidden = $bindable(false),
+    class: className,
+    disabled = false,
+    label,
+    value = label,
+    searchValue = label,
+    wrap = false,
+    children,
+    checkIcon,
+    startIcon: _startIcon,
+    onChange,
+    onToggle,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 </script>
 
-<div role="none" class="sui option {className}" class:wrap hidden={hidden || undefined}>
+<div role="none" class="sui option {className}" class:wrap {hidden}>
   <Button
+    {...restProps}
     role="option"
     tabindex="-1"
     aria-selected={selected}
@@ -63,33 +56,27 @@
     data-type={typeof value}
     data-label={label}
     data-search-value={searchValue}
-    {...$$restProps}
-    on:click
-    on:dblclick
-    on:focus
-    on:blur
-    on:dragover
-    on:dragleave
-    on:dragend
-    on:drop
-    on:select
-    on:change
-    on:change={(event) => {
+    onChange={(event) => {
       selected = event.detail.selected;
+      onChange?.(event);
     }}
-    on:toggle={(event) => {
-      hidden = /** @type {CustomEvent} */ (event).detail.hidden;
+    onToggle={(event) => {
+      hidden = event.detail.hidden;
       selected = false;
+      onToggle?.(event);
     }}
   >
     {#if selected}
-      <slot name="check-icon">
+      {#if checkIcon}
+        {@render checkIcon()}
+      {:else}
         <Icon class="check" name="check" />
-      </slot>
+      {/if}
     {/if}
-    <slot name="start-icon" slot="start-icon" />
-    <slot />
-    <slot name="end-icon" slot="end-icon" />
+    {#snippet startIcon()}
+      {@render _startIcon?.()}
+    {/snippet}
+    {@render children?.()}
   </Button>
 </div>
 

package/package/components/listbox/option.svelte.d.ts

@@ -1,100 +1,70 @@
 export default Option;
-type Option = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    label: string;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    value?: string | undefined;
-    hidden?: boolean | undefined;
-    selected?: boolean | undefined;
-    searchValue?: string | undefined;
-    wrap?: boolean | undefined;
-}, {
-    'check-icon': {};
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-}>, {
-    click: MouseEvent;
-    dblclick: MouseEvent;
-    focus: FocusEvent;
-    blur: FocusEvent;
-    dragover: DragEvent;
-    dragleave: DragEvent;
-    dragend: DragEvent;
-    drop: DragEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+type Option = SvelteComponent<ButtonProps & KeyboardEventHandlers & MouseEventHandlers & FocusEventHandlers & DragEventHandlers & Props & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'check-icon': {};
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "hidden" | "selected" | undefined;
 };
 /**
  * An option within the `<Listbox>` widget. The equivalent of the HTML `<option>` element.
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option
  * @see https://w3c.github.io/aria/#option
  */
-declare const Option: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    label: string;
+declare const Option: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").ButtonProps & import("../../typedefs").KeyboardEventHandlers & import("../../typedefs").MouseEventHandlers & import("../../typedefs").FocusEventHandlers & import("../../typedefs").DragEventHandlers & {
+    /**
+     * - The `class` attribute on the wrapper element.
+     */
     class?: string | undefined;
-    disabled?: boolean | undefined;
-    value?: string | undefined;
-    hidden?: boolean | undefined;
+    /**
+     * - Whether to select the widget. An alias of the `aria-selected`
+     * attribute.
+     */
     selected?: boolean | undefined;
+    /**
+     * - Text label displayed on the item.
+     */
+    label: string;
+    /**
+     * - The value to be searched.
+     */
     searchValue?: string | undefined;
+    /**
+     * - Whether to wrap a long label.
+     */
     wrap?: boolean | undefined;
-}, {
-    'check-icon': {};
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-}>, {
-    click: MouseEvent;
-    dblclick: MouseEvent;
-    focus: FocusEvent;
-    blur: FocusEvent;
-    dragover: DragEvent;
-    dragleave: DragEvent;
-    dragend: DragEvent;
-    drop: DragEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+    /**
+     * - Check icon slot content.
+     */
+    checkIcon?: import("svelte").Snippet<[]> | undefined;
+} & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'check-icon': {};
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-}, {}, string>;
-type $$__sveltets_2_PropsWithChildren<Props, Slots> = Props & (Slots extends {
-    default: any;
-} ? Props extends Record<string, never> ? any : {
-    children?: any;
-} : {});
+}, {}, {}, "hidden" | "selected">;
+type Props = {
+    /**
+     * - The `class` attribute on the wrapper element.
+     */
+    class?: string | undefined;
+    /**
+     * - Whether to select the widget. An alias of the `aria-selected`
+     * attribute.
+     */
+    selected?: boolean | undefined;
+    /**
+     * - Text label displayed on the item.
+     */
+    label: string;
+    /**
+     * - The value to be searched.
+     */
+    searchValue?: string | undefined;
+    /**
+     * - Whether to wrap a long label.
+     */
+    wrap?: boolean | undefined;
+    /**
+     * - Check icon slot content.
+     */
+    checkIcon?: import("svelte").Snippet<[]> | 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/menu/menu-button.svelte

@@ -8,77 +8,53 @@
   import Popup from '../util/popup.svelte';
 
   /**
-   * The `class` attribute on the `<button>` element.
-   * @type {string}
+   * @typedef {object} Props
+   * @property {HTMLElement | undefined} [popupPositionBaseElement] - The base element of
+   * {@link popupPosition}. If omitted, this will be {@link buttonComponent}.
    */
-  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;
-  /**
-   * Where to show the dropdown menu.
-   * @type {import('../../typedefs').PopupPosition}
-   */
-  export let popupPosition = 'bottom-left';
-  /**
-   * The base element of {@link popupPosition}. If omitted, this will be {@link buttonComponent}.
-   * @type {HTMLElement | undefined}
-   */
-  export let popupPositionBaseElement = undefined;
-  /**
-   * Whether to show the backdrop for the popup.
-   * @type {boolean}
-   */
-  export let showPopupBackdrop = false;
-  /**
-   * Text label displayed on the button.
-   * @type {string}
-   */
-  export let label = '';
-  /**
-   * The style variant of the button.
-   * @type {'primary' | 'secondary' | 'tertiary' | 'ghost' | 'link' | undefined}
-   */
-  export let variant = undefined;
-  /**
-   * The size of the button.
-   * @type {'small' | 'medium' | 'large'}
-   */
-  export let size = 'medium';
-  /**
-   * Whether to only show an icon on the button and trim the padding.
-   */
-  export let iconic = false;
 
   /**
-   * Reference to the `Button` component.
-   * @type {Button | undefined}
+   * @type {import('../../typedefs').ButtonProps & import('../../typedefs').CommonEventHandlers &
+   * Props & Record<string, any>}
    */
-  let buttonComponent;
+  let {
+    /* eslint-disable prefer-const */
+    class: className,
+    hidden = false,
+    disabled = false,
+    popupPosition = 'bottom-left',
+    popupPositionBaseElement = undefined,
+    showPopupBackdrop = false,
+    label = '',
+    variant = undefined,
+    size = 'medium',
+    iconic = false,
+    children: _children,
+    startIcon: _startIcon,
+    endIcon: _endIcon,
+    popup,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
+
   /**
-   * Reference to the `Popup` component.
-   * @type {Popup | undefined}
+   * Reference to the `<button>` element.
+   * @type {HTMLButtonElement | undefined}
    */
-  let popupComponent;
+  let buttonElement = $state();
 
   /**
    * Move focus to the `<button>` element.
    */
   export const focus = () => {
-    buttonComponent?.element?.focus();
+    buttonElement?.focus();
   };
 </script>
 
 <div role="none" class="wrapper">
   <Button
+    {...restProps}
+    bind:element={buttonElement}
     class="sui menu-button {className}"
     {hidden}
     {disabled}
@@ -87,21 +63,24 @@
     {size}
     {iconic}
     aria-haspopup="menu"
-    {...$$restProps}
-    bind:this={buttonComponent}
   >
-    <slot name="start-icon" slot="start-icon" />
-    <slot />
-    <slot name="end-icon" slot="end-icon" />
+    {#snippet startIcon()}
+      {@render _startIcon?.()}
+    {/snippet}
+    {#snippet children()}
+      {@render _children?.()}
+    {/snippet}
+    {#snippet endIcon()}
+      {@render _endIcon?.()}
+    {/snippet}
   </Button>
 </div>
 
 <Popup
-  anchor={buttonComponent?.element}
+  anchor={buttonElement}
   position={popupPosition}
   positionBaseElement={popupPositionBaseElement}
   showBackdrop={showPopupBackdrop}
-  bind:this={popupComponent}
 >
-  <slot name="popup" />
+  {@render popup?.()}
 </Popup>

package/package/components/menu/menu-button.svelte.d.ts

@@ -1,39 +1,8 @@
 export default MenuButton;
-type MenuButton = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    focus?: (() => void) | undefined;
-    label?: string | undefined;
-    size?: "small" | "medium" | "large" | undefined;
-    hidden?: boolean | undefined;
-    variant?: "link" | "primary" | "secondary" | "tertiary" | "ghost" | undefined;
-    iconic?: boolean | undefined;
-    popupPosition?: PopupPosition | undefined;
-    showPopupBackdrop?: boolean | undefined;
-    popupPositionBaseElement?: HTMLElement | undefined;
-}, {
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-    popup: {};
-}>, {
+type MenuButton = SvelteComponent<ButtonProps & KeyboardEventHandlers & MouseEventHandlers & FocusEventHandlers & DragEventHandlers & Props & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-    popup: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "" | undefined;
 } & {
     focus: () => void;
 };
@@ -41,47 +10,24 @@ type MenuButton = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
  * A button to open a `<Menu>` widget.
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/
  */
-declare const MenuButton: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    focus?: (() => void) | undefined;
-    label?: string | undefined;
-    size?: "small" | "medium" | "large" | undefined;
-    hidden?: boolean | undefined;
-    variant?: "primary" | "secondary" | "tertiary" | "ghost" | "link" | undefined;
-    iconic?: boolean | undefined;
-    popupPosition?: import("../../typedefs").PopupPosition | undefined;
-    showPopupBackdrop?: boolean | undefined;
+declare const MenuButton: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").ButtonProps & import("../../typedefs").KeyboardEventHandlers & import("../../typedefs").MouseEventHandlers & import("../../typedefs").FocusEventHandlers & import("../../typedefs").DragEventHandlers & {
+    /**
+     * - The base element of
+     * {@link popupPosition}. If omitted, this will be {@link buttonComponent}.
+     */
     popupPositionBaseElement?: HTMLElement | undefined;
-}, {
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-    popup: {};
-}>, {
+} & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    'start-icon': {
-        slot: string;
-    };
-    default: {};
-    'end-icon': {
-        slot: string;
-    };
-    popup: {};
-}, {
+}, {}, {
     focus: () => void;
-}, string>;
-type $$__sveltets_2_PropsWithChildren<Props, Slots> = Props & (Slots extends {
-    default: any;
-} ? Props extends Record<string, never> ? any : {
-    children?: any;
-} : {});
+}, "">;
+type Props = {
+    /**
+     * - The base element of
+     * {@link popupPosition}. If omitted, this will be {@link buttonComponent}.
+     */
+    popupPositionBaseElement?: HTMLElement | 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;