@sveltia/ui 0.16.0 → 0.17.0

package/package/components/menu/menu-item-checkbox.svelte

@@ -8,58 +8,46 @@
   import MenuItem from './menu-item.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @type {import('../../typedefs').ButtonProps & import('../../typedefs').MenuItemProps &
+   * import('../../typedefs').CommonEventHandlers & 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 mark the widget checked.
-   * @type {boolean}
-   */
-  export let checked = false;
-  /**
-   * Text label displayed on the item.
-   * @type {string | undefined}
-   */
-  export let label = '';
-  /**
-   * Name of `<Icon>` displayed before the label.
-   */
-  export let iconName = '';
-  /**
-   * ARIA label of `<Icon>` displayed before the label.
-   */
-  export let iconLabel = '';
+  let {
+    /* eslint-disable prefer-const */
+    checked = $bindable(false),
+    class: className,
+    hidden = false,
+    disabled = false,
+    label = '',
+    children: _children,
+    startIcon: _startIcon,
+    onChange,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 </script>
 
 <MenuItem
+  {...restProps}
   role="menuitemcheckbox"
   class="sui menu-item-checkbox {className}"
   {label}
   {hidden}
   {disabled}
   aria-checked={checked}
-  {iconName}
-  {iconLabel}
-  {...$$restProps}
-  on:click
-  on:select
-  on:change
-  on:change={(event) => {
+  onChange={(event) => {
+    onChange?.(event);
     checked = event.detail.checked;
   }}
 >
-  <slot />
-  <svelte:component this={checked ? Icon : undefined} slot="end-icon" name="check" />
+  {#snippet startIcon()}
+    {@render _startIcon?.()}
+  {/snippet}
+  {#snippet children()}
+    {@render _children?.()}
+  {/snippet}
+  {#snippet endIcon()}
+    {#if checked}
+      <Icon name="check" />
+    {/if}
+  {/snippet}
 </MenuItem>

package/package/components/menu/menu-item-checkbox.svelte.d.ts

@@ -1,55 +1,16 @@
 export default MenuItemCheckbox;
-type MenuItemCheckbox = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    checked?: boolean | undefined;
-    hidden?: boolean | undefined;
-    iconName?: string | undefined;
-    iconLabel?: string | undefined;
-}, {
-    default: {};
-}>, {
-    click: MouseEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+type MenuItemCheckbox = SvelteComponent<ButtonProps & MenuItemProps & KeyboardEventHandlers & MouseEventHandlers & FocusEventHandlers & DragEventHandlers & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "checked" | undefined;
 };
 /**
  * A menu item widget with a checkbox.
  * @see https://w3c.github.io/aria/#menuitemcheckbox
  */
-declare const MenuItemCheckbox: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    checked?: boolean | undefined;
-    hidden?: boolean | undefined;
-    iconName?: string | undefined;
-    iconLabel?: string | undefined;
-}, {
-    default: {};
-}>, {
-    click: MouseEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+declare const MenuItemCheckbox: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").ButtonProps & import("../../typedefs").MenuItemProps & import("../../typedefs").KeyboardEventHandlers & import("../../typedefs").MouseEventHandlers & import("../../typedefs").FocusEventHandlers & import("../../typedefs").DragEventHandlers & 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;
-} : {});
+}, {}, {}, "checked">;
 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-item-group.svelte

@@ -6,45 +6,48 @@
   import { generateElementId } from '@sveltia/utils/element';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @typedef {object} Props
+   * @property {string} [class] - The `class` attribute on the wrapper element.
+   * @property {boolean} [hidden] - Whether to hide the widget. An alias of the `aria-hidden`
+   * attribute.
+   * @property {boolean} [disabled] - Whether to disable the widget. An alias of the `aria-disabled`
+   * attribute.
+   * @property {string} [title] - Text label displayed above the group items.
    */
-  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;
+
   /**
-   * Text label displayed above the group items.
+   * @type {import('../../typedefs').CommonEventHandlers & Props & Record<string, any>}
    */
-  export let title = '';
+  let {
+    /* eslint-disable prefer-const */
+    class: className,
+    hidden = false,
+    disabled = false,
+    title = '',
+    children,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 
   const id = generateElementId('group');
 </script>
 
 <div
+  {...restProps}
   role="group"
   {id}
   class="sui menu-item-group {className}"
-  hidden={hidden || undefined}
+  {hidden}
   aria-hidden={hidden}
   aria-disabled={disabled}
   aria-labelledby={title ? `${id}-title` : undefined}
   aria-roledescription="menu item group"
-  {...$$restProps}
 >
   {#if title}
     <div role="none" class="title" id="{id}-title">{title}</div>
   {/if}
   <div role="none" class="inner" inert={disabled}>
-    <slot />
+    {@render children?.()}
   </div>
 </div>
 

package/package/components/menu/menu-item-group.svelte.d.ts

@@ -1,38 +1,52 @@
 export default MenuItemGroup;
-type MenuItemGroup = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    title?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
+type MenuItemGroup = SvelteComponent<KeyboardEventHandlers & MouseEventHandlers & FocusEventHandlers & DragEventHandlers & Props & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "" | undefined;
 };
 /** A menu item group. */
-declare const MenuItemGroup: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
+declare const MenuItemGroup: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").KeyboardEventHandlers & import("../../typedefs").MouseEventHandlers & import("../../typedefs").FocusEventHandlers & import("../../typedefs").DragEventHandlers & {
+    /**
+     * - 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;
+    /**
+     * - Text label displayed above the group items.
+     */
     title?: string | undefined;
-    hidden?: boolean | undefined;
-}, {
-    default: {};
-}>, {
+} & 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;
+    /**
+     * - Text label displayed above the group items.
+     */
+    title?: string | 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-item-radio.svelte

@@ -9,58 +9,46 @@
   import MenuItem from './menu-item.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
+   * @type {import('../../typedefs').ButtonProps & import('../../typedefs').MenuItemProps &
+   * import('../../typedefs').CommonEventHandlers & 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 check the widget. An alias of the `aria-checked` attribute.
-   * @type {boolean}
-   */
-  export let checked = false;
-  /**
-   * Text label displayed on the item.
-   * @type {string | undefined}
-   */
-  export let label = '';
-  /**
-   * Name of `<Icon>` displayed before the label.
-   */
-  export let iconName = '';
-  /**
-   * ARIA label of `<Icon>` displayed before the label.
-   */
-  export let iconLabel = '';
+  let {
+    /* eslint-disable prefer-const */
+    checked = $bindable(false),
+    class: className,
+    hidden = false,
+    disabled = false,
+    label = '',
+    children: _children,
+    startIcon: _startIcon,
+    onChange,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
 </script>
 
 <MenuItem
+  {...restProps}
   role="menuitemradio"
   class="sui menu-item-radio {className}"
   {label}
   {hidden}
   {disabled}
   aria-checked={checked}
-  {iconName}
-  {iconLabel}
-  {...$$restProps}
-  on:click
-  on:select
-  on:change
-  on:change={(event) => {
+  onChange={(event) => {
+    onChange?.(event);
     checked = event.detail.checked;
   }}
 >
-  <slot />
-  <svelte:component this={checked ? Icon : undefined} slot="end-icon" name="check" />
+  {#snippet startIcon()}
+    {@render _startIcon?.()}
+  {/snippet}
+  {#snippet children()}
+    {@render _children?.()}
+  {/snippet}
+  {#snippet endIcon()}
+    {#if checked}
+      <Icon name="check" />
+    {/if}
+  {/snippet}
 </MenuItem>

package/package/components/menu/menu-item-radio.svelte.d.ts

@@ -1,56 +1,17 @@
 export default MenuItemRadio;
-type MenuItemRadio = SvelteComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    checked?: boolean | undefined;
-    hidden?: boolean | undefined;
-    iconName?: string | undefined;
-    iconLabel?: string | undefined;
-}, {
-    default: {};
-}>, {
-    click: MouseEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+type MenuItemRadio = SvelteComponent<ButtonProps & MenuItemProps & KeyboardEventHandlers & MouseEventHandlers & FocusEventHandlers & DragEventHandlers & Record<string, any>, {
     [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> & {
-    $$bindings?: string | undefined;
+}, {}> & {
+    $$bindings?: "checked" | undefined;
 };
 /**
  * A menu item widget with a radio. Only one item can be selected within the parent `<Menu>` or
  * `<MenuItemGroup>` component.
  * @see https://w3c.github.io/aria/#menuitemradio
  */
-declare const MenuItemRadio: $$__sveltets_2_IsomorphicComponent<$$__sveltets_2_PropsWithChildren<{
-    [x: string]: any;
-    class?: string | undefined;
-    disabled?: boolean | undefined;
-    label?: string | undefined;
-    checked?: boolean | undefined;
-    hidden?: boolean | undefined;
-    iconName?: string | undefined;
-    iconLabel?: string | undefined;
-}, {
-    default: {};
-}>, {
-    click: MouseEvent;
-    select: CustomEvent<any>;
-    change: CustomEvent<any>;
-} & {
+declare const MenuItemRadio: $$__sveltets_2_IsomorphicComponent<import("../../typedefs").ButtonProps & import("../../typedefs").MenuItemProps & import("../../typedefs").KeyboardEventHandlers & import("../../typedefs").MouseEventHandlers & import("../../typedefs").FocusEventHandlers & import("../../typedefs").DragEventHandlers & 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;
-} : {});
+}, {}, {}, "checked">;
 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-item.svelte

@@ -4,104 +4,95 @@
   @see https://w3c.github.io/aria/#menuitem
 -->
 <script>
-  import { writable } from 'svelte/store';
   import Button from '../button/button.svelte';
   import Icon from '../icon/icon.svelte';
-  import Menu from './menu.svelte';
   import Popup from '../util/popup.svelte';
+  import Menu from './menu.svelte';
 
   /**
-   * The `class` attribute on the wrapper element.
-   * @type {string}
-   */
-  let className = '';
-  export { className as class };
-  /**
-   * The `role` attribute on the `<button>` element.
-   * @type {'menuitem' | 'menuitemcheckbox' | 'menuitemradio'}
-   */
-  export let role = 'menuitem';
-  /**
-   * 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}
+   * @type {import('../../typedefs').ButtonProps & import('../../typedefs').MenuItemProps &
+   * import('../../typedefs').CommonEventHandlers & Record<string, any>}
    */
-  export let disabled = false;
-  /**
-   * Text label displayed on the item.
-   * @type {string | undefined}
-   */
-  export let label = '';
-  /**
-   * Name of `<Icon>` displayed before the label.
-   */
-  export let iconName = '';
+  let {
+    /* eslint-disable prefer-const */
+    class: className,
+    role = 'menuitem',
+    hidden = false,
+    disabled = false,
+    label = '',
+    children: _children,
+    startIcon: _startIcon,
+    endIcon: _endIcon,
+    chevronIcon,
+    items,
+    onChange,
+    onSelect,
+    ...restProps
+    /* eslint-enable prefer-const */
+  } = $props();
+
+  let isPopupOpen = $state(false);
+
   /**
-   * ARIA label of `<Icon>` displayed before the label.
+   * Reference to the `<button>` element.
+   * @type {HTMLButtonElement | undefined}
    */
-  export let iconLabel = '';
+  let buttonElement = $state();
 
-  /** @type {Button} */
-  let buttonComponent;
-  let isPopupOpen = writable(false);
-
-  $: hasChildren = role === 'menuitem' && $$slots.children;
+  const hasItems = $derived(role === 'menuitem' && !!items);
 </script>
 
-<div role="none" class="sui menuitem {className}" hidden={hidden || undefined}>
+<div role="none" class="sui menuitem {className}" {hidden}>
   <Button
+    bind:element={buttonElement}
+    {...restProps}
     {role}
     {hidden}
     {disabled}
-    aria-haspopup={hasChildren ? 'menu' : undefined}
-    aria-expanded={hasChildren ? $isPopupOpen : undefined}
-    {...$$restProps}
-    bind:this={buttonComponent}
-    on:click
-    on:mouseenter={() => {
-      if (hasChildren) {
-        $isPopupOpen = true;
+    aria-haspopup={hasItems ? 'menu' : undefined}
+    aria-expanded={hasItems ? isPopupOpen : undefined}
+    onmouseenter={() => {
+      if (hasItems) {
+        isPopupOpen = true;
       }
     }}
-    on:mouseleave={() => {
-      if (hasChildren) {
-        $isPopupOpen = false;
+    onmouseleave={() => {
+      if (hasItems) {
+        isPopupOpen = false;
       }
     }}
-    on:focus
-    on:blur
-    on:select
-    on:change
+    {onChange}
+    {onSelect}
   >
-    <slot name="start-icon" slot="start-icon">
-      {#if iconName}
-        <Icon name={iconName} aria-label={iconLabel} />
-      {/if}
-    </slot>
-    <div role="none" class="content" class:label={!!label}>
-      {#if label}
-        {label}
-      {:else}
-        <slot />
+    {#snippet startIcon()}
+      {@render _startIcon?.()}
+    {/snippet}
+    {#snippet children()}
+      <div role="none" class="content" class:label={!!label}>
+        {#if label}
+          {label}
+        {:else}
+          {@render _children?.()}
+        {/if}
+      </div>
+      {#if hasItems}
+        <span role="none" class="icon-outer">
+          {#if chevronIcon}
+            {@render chevronIcon()}
+          {:else}
+            <Icon name="chevron_right" />
+          {/if}
+        </span>
       {/if}
-    </div>
-    <slot name="end-icon" slot="end-icon" />
-    {#if hasChildren}
-      <span role="none" class="icon-outer">
-        <slot name="chevron-icon">
-          <Icon name="chevron_right" />
-        </slot>
-      </span>
-    {/if}
+    {/snippet}
+    {#snippet endIcon()}
+      {@render _endIcon?.()}
+    {/snippet}
   </Button>
-  {#if hasChildren}
-    <Popup anchor={buttonComponent?.element} position="right-top" bind:open={isPopupOpen}>
+  {#if hasItems}
+    <Popup anchor={buttonElement} position="right-top" bind:open={isPopupOpen}>
       <Menu>
-        <slot name="children" />
+        {@render items?.()}
       </Menu>
     </Popup>
   {/if}