wave-ui 3.27.2 → 4.0.0

package/dist/types/types/components/WCheckbox.d.ts

@@ -68,6 +68,40 @@ export interface WaveCheckboxProps {
      * @see https://antoniandre.github.io/wave-ui/w-checkbox
      */
     round?: boolean;
+    /**
+     * Sets the checkbox size to extra small (~12 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-checkbox
+     */
+    xs?: boolean;
+    /**
+     * Sets the checkbox size to small (~16 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-checkbox
+     */
+    sm?: boolean;
+    /**
+     * Sets the checkbox size to medium, which is the same as the default size (~18 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-checkbox
+     */
+    md?: boolean;
+    /**
+     * Sets the checkbox size to large (~20 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-checkbox
+     */
+    lg?: boolean;
+    /**
+     * Sets the checkbox size to extra large (~24 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-checkbox
+     */
+    xl?: boolean;
     /**
      * TODO: Add Description
      * @property {boolean} dark

package/dist/types/types/components/WCheckboxes.d.ts

@@ -68,6 +68,36 @@ export interface WaveCheckboxesProps {
      * @see https://antoniandre.github.io/wave-ui/colors
      */
     labelColor?: string;
+    /**
+     * Sets all checkboxes to extra small (~12 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-checkboxes
+     */
+    xs?: boolean;
+    /**
+     * Sets all checkboxes to small (~16 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-checkboxes
+     */
+    sm?: boolean;
+    /**
+     * Sets all checkboxes to medium, which is the same as the default size (~18 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-checkboxes
+     */
+    md?: boolean;
+    /**
+     * Sets all checkboxes to large (~20 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-checkboxes
+     */
+    lg?: boolean;
+    /**
+     * Sets all checkboxes to extra large (~24 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-checkboxes
+     */
+    xl?: boolean;
 }
 export interface WaveCheckboxesEmits {
     /**

package/dist/types/types/components/WInput.d.ts

@@ -172,6 +172,40 @@ export interface WaveInputProps {
      * @see https://antoniandre.github.io/wave-ui/w-input
      */
     files?: Array<any>;
+    /**
+     * Sets the height of the input field to extra small (~20 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-input
+     */
+    xs?: boolean;
+    /**
+     * Sets the height of the input field to small (~24 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-input
+     */
+    sm?: boolean;
+    /**
+     * Sets the height of the input field to medium, which is the same as the default height (~28 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-input
+     */
+    md?: boolean;
+    /**
+     * Sets the height of the input field to large (~32 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-input
+     */
+    lg?: boolean;
+    /**
+     * Sets the height of the input field to extra large (~38 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-input
+     */
+    xl?: boolean;
     /**
      * TODO: Add Description
      * @property {boolean} dark

package/dist/types/types/components/WList.d.ts

@@ -145,6 +145,13 @@ export interface WaveListProps {
      * @see https://antoniandre.github.io/wave-ui/w-list
      */
     arrowsNavigation?: boolean;
+    /**
+     * When `true`, disables the pointer ripple on interactive rows for this list only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-list
+     */
+    noRipple?: boolean;
 }
 export interface WaveListEmits {
     /**

package/dist/types/types/components/WMenu.d.ts

@@ -234,19 +234,25 @@ export interface WaveMenuMethods extends MethodOptions {
 }
 export type WaveMenuSlots = SlotsType<{
     /**
-     * `This slot is required and must have the `v-on="on"` directive set on it for the menu to toggle correctly.`
+     * Place the element that triggers the menu inside this slot. Event listeners are attached
+     * automatically — no `v-on="on"` binding is required on the activator element.
      * The activator can be any visible DOM element or mounted component.
-     * @param {any} on TODO: Describe me!
+     * When this slot is used (legacy API), the default slot becomes the menu content.
      * @see https://antoniandre.github.io/wave-ui/w-menu
      */
-    'activator': (_: {
-        on: any;
-    }) => any;
+    'activator': () => any;
     /**
-     * The menu content.
+     * **New API:** When no `#activator` slot is used, the default slot is the activator element.
+     * **Legacy API:** When an `#activator` slot is provided, the default slot is the menu content.
      * @see https://antoniandre.github.io/wave-ui/w-menu
      */
     'default': () => any;
+    /**
+     * The menu body content. Used with the new API (default slot = activator).
+     * When `custom` is `false` (default), the content is placed inside a `w-card`.
+     * @see https://antoniandre.github.io/wave-ui/w-menu
+     */
+    'content': () => any;
     /**
      * By default (when `custom` is set to false), the menu uses a `w-card`. This slot allows a custom title for the `w-card`.
      * @see https://antoniandre.github.io/wave-ui/w-menu

package/dist/types/types/components/WRadio.d.ts

@@ -56,6 +56,40 @@ export interface WaveRadioProps {
      * @see https://antoniandre.github.io/wave-ui/w-radio
      */
     noRipple?: boolean;
+    /**
+     * Sets the radio button size to extra small (~12 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-radio
+     */
+    xs?: boolean;
+    /**
+     * Sets the radio button size to small (~16 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-radio
+     */
+    sm?: boolean;
+    /**
+     * Sets the radio button size to medium, which is the same as the default size (~18 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-radio
+     */
+    md?: boolean;
+    /**
+     * Sets the radio button size to large (~20 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-radio
+     */
+    lg?: boolean;
+    /**
+     * Sets the radio button size to extra large (~24 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-radio
+     */
+    xl?: boolean;
     /**
      * TODO: Add Description
      * @property {boolean} dark

package/dist/types/types/components/WRadios.d.ts

@@ -62,6 +62,36 @@ export interface WaveRadiosProps {
      * @see https://antoniandre.github.io/wave-ui/colors
      */
     labelColor?: string;
+    /**
+     * Sets all radio buttons to extra small (~12 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-radios
+     */
+    xs?: boolean;
+    /**
+     * Sets all radio buttons to small (~16 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-radios
+     */
+    sm?: boolean;
+    /**
+     * Sets all radio buttons to medium, which is the same as the default size (~18 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-radios
+     */
+    md?: boolean;
+    /**
+     * Sets all radio buttons to large (~20 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-radios
+     */
+    lg?: boolean;
+    /**
+     * Sets all radio buttons to extra large (~24 px at 14 px base font size) via the cascading `--w-size` CSS variable.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-radios
+     */
+    xl?: boolean;
 }
 export interface WaveRadiosEmits {
     /**

package/dist/types/types/components/WScrollable.d.ts

@@ -0,0 +1,143 @@
+import type { ComputedGetter, ComputedOptions, DefineComponent, EmitsOptions, ExtractDefaultPropTypes, MethodOptions, SlotsType } from 'vue';
+import type { PublicProps, ResolveProps } from '../extra-vue-types';
+export type WaveScrollableScrollSource = 'native' | 'wheel' | 'keyboard' | 'api' | 'drag';
+export interface WaveScrollableScrollPayload {
+    top: number;
+    left: number;
+    maxTop: number;
+    maxLeft: number;
+    topPercent: number;
+    leftPercent: number;
+    source: WaveScrollableScrollSource;
+}
+/** Per-axis pixel offsets for the `scroll-position` prop. */
+export interface WaveScrollableScrollPosition {
+    top?: number;
+    left?: number;
+}
+/** `scroll-position` prop: a number is the primary axis (`top` when vertical, `left` when horizontal), or set one or both axes with an object. */
+export type WaveScrollableScrollPositionInput = number | WaveScrollableScrollPosition;
+/** Accepted `scrollbar` prop values. */
+export type WaveScrollableScrollbar = 0 | 1 | '0' | '1' | 'hover' | 'interaction';
+export interface WaveScrollableProps {
+    /**
+     * Applies a color to the scrollbar thumb.
+     * @property {string} color - Default: 'primary'
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    color?: string;
+    /**
+     * Applies a color to the scrollbar track.
+     * @property {string} bgColor
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    bgColor?: string;
+    /**
+     * Limits the component width.
+     * @property {number|string} width
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    width?: number | string;
+    /**
+     * Limits the component height.
+     * @property {number|string} height
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    height?: number | string;
+    /**
+     * Classes applied to the inner scroll container (padding, typography, etc.).
+     * @property {string|object|array} contentClass
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    contentClass?: string | Record<string, boolean> | (string | Record<string, boolean>)[];
+    /**
+     * Fully inert: no keyboard, wheel, or custom drag; root gets aria-disabled and tabindex -1.
+     * @property {boolean} disabled - Default: false
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    disabled?: boolean;
+    /**
+     * Sets the root tabindex.
+     * @property {number|string} tabindex - Default: 0
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    tabindex?: number | string;
+    /**
+     * Defines the wheel and arrow-key step in pixels.
+     * @property {number} wheelStep - Default: 40
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    wheelStep?: number;
+    /**
+     * When true, scrolling is along X (`scrollLeft`); default false is vertical (`scrollTop`).
+     * @property {boolean} horizontal - Default: false
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    horizontal?: boolean;
+    /**
+     * Custom scrollbar: `1` (default, shown when there is overflow), `0` (hide track), `'hover'`, `'interaction'`.
+     * @property {WaveScrollableScrollbar} scrollbar - Default: 1
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    scrollbar?: WaveScrollableScrollbar;
+    /**
+     * Programmatic scroll: applied on change (deep watch for objects) and after first layout.
+     * A number sets the primary axis; an object sets `top` and/or `left` when those keys are present.
+     * @property {WaveScrollableScrollPositionInput|null} scrollPosition - Default: null
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    scrollPosition?: WaveScrollableScrollPositionInput | null;
+}
+export interface WaveScrollableEmits {
+    /**
+     * Emitted on each scroll update.
+     * @param payload - Current scroll position and source.
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    'onScroll'?: (payload: WaveScrollableScrollPayload) => void;
+    /**
+     * Emitted when a scroll sequence starts.
+     * @param payload - Current scroll position and source.
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    'onScrollStart'?: (payload: WaveScrollableScrollPayload) => void;
+    /**
+     * Emitted when scrolling has settled after the last event.
+     * @param payload - Current scroll position; `source` is often `'native'`.
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    'onScrollEnd'?: (payload: WaveScrollableScrollPayload) => void;
+}
+export interface WaveScrollableComputeds extends ComputedOptions {
+    hasOverflow: ComputedGetter<boolean>;
+    isHorizontal: ComputedGetter<boolean>;
+}
+export interface WaveScrollableMethods extends MethodOptions {
+    scroll(value?: number | {
+        top?: number;
+        left?: number;
+        behavior?: 'auto' | 'smooth';
+    }): void;
+    scrollTo(options?: {
+        top?: number;
+        left?: number;
+        behavior?: 'auto' | 'smooth';
+    }): void;
+    scrollBy(options?: {
+        top?: number;
+        left?: number;
+        behavior?: 'auto' | 'smooth';
+    }): void;
+    scrollToStart(): void;
+    scrollToEnd(): void;
+    focus(): void;
+    refresh(): void;
+}
+export type WaveScrollableSlots = SlotsType<{
+    /**
+     * Scrollable content.
+     * @see https://antoniandre.github.io/wave-ui/w-scrollable
+     */
+    'default': () => any;
+}>;
+export type WScrollable = DefineComponent<WaveScrollableProps, {}, {}, WaveScrollableComputeds, WaveScrollableMethods, {}, {}, WaveScrollableEmits & EmitsOptions, string, PublicProps, ResolveProps<WaveScrollableProps & WaveScrollableEmits, EmitsOptions>, ExtractDefaultPropTypes<WaveScrollableProps>, WaveScrollableSlots>;

package/dist/types/types/components/WScrollable.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/types/components/WSelect.d.ts

@@ -211,6 +211,40 @@ export interface WaveSelectProps {
      * @see https://antoniandre.github.io/wave-ui/w-select
      */
     fitToContent?: boolean;
+    /**
+     * Sets the height of the select field to extra small (~20 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-select
+     */
+    xs?: boolean;
+    /**
+     * Sets the height of the select field to small (~24 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-select
+     */
+    sm?: boolean;
+    /**
+     * Sets the height of the select field to medium, which is the same as the default height (~28 px at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-select
+     */
+    md?: boolean;
+    /**
+     * Sets the height of the select field to large (~32 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-select
+     */
+    lg?: boolean;
+    /**
+     * Sets the height of the select field to extra large (~38 px at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-select
+     */
+    xl?: boolean;
 }
 export interface WaveSelectEmits {
     /**

package/dist/types/types/components/WSwitch.d.ts

@@ -55,6 +55,40 @@ export interface WaveSwitchProps {
      * @see https://antoniandre.github.io/wave-ui/w-switch
      */
     loading?: boolean | number;
+    /**
+     * Sets the switch size to extra small (~12 px thumb at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xs
+     * @see https://antoniandre.github.io/wave-ui/w-switch
+     */
+    xs?: boolean;
+    /**
+     * Sets the switch size to small (~16 px thumb at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} sm
+     * @see https://antoniandre.github.io/wave-ui/w-switch
+     */
+    sm?: boolean;
+    /**
+     * Sets the switch size to medium, which is the same as the default size (~18 px thumb at 14 px base font size).
+     * @property {boolean} md
+     * @see https://antoniandre.github.io/wave-ui/w-switch
+     */
+    md?: boolean;
+    /**
+     * Sets the switch size to large (~20 px thumb at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} lg
+     * @see https://antoniandre.github.io/wave-ui/w-switch
+     */
+    lg?: boolean;
+    /**
+     * Sets the switch size to extra large (~24 px thumb at 14 px base font size).
+     * Equivalent to setting the CSS variable `--w-size` to the corresponding value.
+     * @property {boolean} xl
+     * @see https://antoniandre.github.io/wave-ui/w-switch
+     */
+    xl?: boolean;
     /**
      * TODO: Add Description
      * @property {boolean} dark

package/dist/types/types/components/WTable.d.ts

@@ -169,6 +169,13 @@ export interface WaveTableProps {
      * @see https://antoniandre.github.io/wave-ui/w-table
      */
     forceSelection?: boolean;
+    /**
+     * When `true`, disables the pointer ripple on sortable headers and interactive row cells for this table only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-table
+     */
+    noRipple?: boolean;
     /**
      * In order to keep the same row selected after sorting or filtering, each row is assigned a unique identifier.
      * By default the expanded rows array will use an `id` key, if present in the item object, or will assign an

package/dist/types/types/components/WTabs.d.ts

@@ -169,6 +169,13 @@ export interface WaveTabsProps {
      * @see https://antoniandre.github.io/wave-ui/w-tabs
      */
     keepInDom?: boolean;
+    /**
+     * When `true`, disables the tab bar pointer ripple on this tabs instance only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-tabs
+     */
+    noRipple?: boolean;
 }
 export interface WaveTabsEmits {
     /**

package/dist/types/types/components/WTag.d.ts

@@ -116,6 +116,13 @@ export interface WaveTagProps {
      * @see https://antoniandre.github.io/wave-ui/w-tag
      */
     light?: boolean;
+    /**
+     * When `true`, disables the pointer ripple for clickable tags on this instance.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-tag
+     */
+    noRipple?: boolean;
 }
 export interface WaveTagEmits {
     /**

package/dist/types/types/components/WTooltip.d.ts

@@ -8,6 +8,12 @@ export interface WaveTooltipProps {
      * @see https://antoniandre.github.io/wave-ui/w-tooltip
      */
     modelValue?: any;
+    /**
+     * Simple string content for the tooltip. For rich/complex content, use the `#tooltip` slot instead.
+     * @property {string} tooltip
+     * @see https://antoniandre.github.io/wave-ui/w-tooltip
+     */
+    tooltip?: string;
     /**
      * Triggers the tooltip apparition on activator click instead of hover by default. Another click on the activator will hide the tooltip.
      * @property {boolean} showOnClick
@@ -159,18 +165,25 @@ export interface WaveTooltipMethods extends MethodOptions {
 }
 export type WaveTooltipSlots = SlotsType<{
     /**
-     * `This slot is required and must have the `v-on="on"` directive set on it for the tooltip to toggle correctly.`
-     * The activator can be any visible DOM element or mounted component.
-     * @param {any} on TODO: Describe me!
+     * The activator element — the element the tooltip appears around on hover/click.
+     * When using the new API (without `#activator`), pass the activator as the default slot
+     * and use the `tooltip` prop or `#tooltip` named slot for the tooltip content.
+     * When using the legacy API, pass the activator here and put the tooltip content in the
+     * default slot.
      * @see https://antoniandre.github.io/wave-ui/w-tooltip
      */
-    'activator': (_: {
-        on: any;
-    }) => any;
+    'activator': () => any;
     /**
-     * The tooltip content.
+     * **New API:** When no `#activator` slot is used, the default slot is the activator element.
+     * **Legacy API:** When an `#activator` slot is provided, the default slot is the tooltip content.
      * @see https://antoniandre.github.io/wave-ui/w-tooltip
      */
     'default': () => any;
+    /**
+     * Rich tooltip content. Use this slot instead of the `tooltip` prop when the content is
+     * complex (HTML, components, multi-line, etc.). Only used with the new API (default slot = activator).
+     * @see https://antoniandre.github.io/wave-ui/w-tooltip
+     */
+    'tooltip': () => any;
 }>;
 export type WTooltip = DefineComponent<WaveTooltipProps, {}, {}, WaveTooltipComputeds, WaveTooltipMethods, {}, {}, WaveTooltipEmits & EmitsOptions, string, PublicProps, ResolveProps<WaveTooltipProps & WaveTooltipEmits, EmitsOptions>, ExtractDefaultPropTypes<WaveTooltipProps>, WaveTooltipSlots>;