wave-ui 3.28.0 → 4.0.1

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/WMenu.d.ts

@@ -1,5 +1,6 @@
 import type { ComputedGetter, ComputedOptions, DefineComponent, EmitsOptions, ExtractDefaultPropTypes, MethodOptions, SlotsType } from 'vue';
 import type { PublicProps, ResolveProps } from '../extra-vue-types';
+import type { WaveDetachableMixinInstance } from '../mixins/detachable';
 export interface WaveMenuProps {
     /**
      * ``value` in Vue 2.`
@@ -234,23 +235,29 @@ 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
      */
     'title': () => any;
 }>;
-export type WMenu = DefineComponent<WaveMenuProps, {}, {}, WaveMenuComputeds, WaveMenuMethods, {}, {}, WaveMenuEmits & EmitsOptions, string, PublicProps, ResolveProps<WaveMenuProps & WaveMenuEmits, EmitsOptions>, ExtractDefaultPropTypes<WaveMenuProps>, WaveMenuSlots>;
+export type WMenu = DefineComponent<WaveMenuProps, {}, WaveDetachableMixinInstance, WaveMenuComputeds, WaveMenuMethods, {}, {}, WaveMenuEmits & EmitsOptions, string, PublicProps, ResolveProps<WaveMenuProps & WaveMenuEmits, EmitsOptions>, ExtractDefaultPropTypes<WaveMenuProps>, WaveMenuSlots>;

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/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/WTooltip.d.ts

@@ -1,5 +1,6 @@
 import type { ComputedGetter, ComputedOptions, DefineComponent, EmitsOptions, ExtractDefaultPropTypes, MethodOptions, SlotsType } from 'vue';
 import type { PublicProps, ResolveProps } from '../extra-vue-types';
+import type { WaveDetachableMixinInstance } from '../mixins/detachable';
 export interface WaveTooltipProps {
     /**
      * ``value` in Vue 2.`
@@ -8,6 +9,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 +166,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>;
+export type WTooltip = DefineComponent<WaveTooltipProps, {}, WaveDetachableMixinInstance, WaveTooltipComputeds, WaveTooltipMethods, {}, {}, WaveTooltipEmits & EmitsOptions, string, PublicProps, ResolveProps<WaveTooltipProps & WaveTooltipEmits, EmitsOptions>, ExtractDefaultPropTypes<WaveTooltipProps>, WaveTooltipSlots>;

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

@@ -0,0 +1,104 @@
+import type { ComputedOptions, DefineComponent, EmitsOptions, ExtractDefaultPropTypes, MethodOptions, SlotsType } from 'vue';
+import type { PublicProps, ResolveProps } from '../extra-vue-types';
+export interface WaveTransitionBaseProps {
+    /**
+     * Triggers the transition on the initial render of the element.
+     * @property {boolean} appear
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    appear?: boolean;
+    /**
+     * Overrides the default CSS transition/animation duration (in milliseconds or as a CSS value string).
+     * @property {number | string} duration
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    duration?: number | string;
+    /**
+     * Controls the timing of enter/leave transitions when switching between two elements.
+     * Use `'out-in'` so the current element transitions out before the new one enters, or
+     * `'in-out'` for the reverse order. Leave unset for simultaneous enter + leave.
+     * @property {'out-in' | 'in-out'} mode
+     * @see https://vuejs.org/guide/built-ins/transition.html#transition-modes
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    mode?: 'out-in' | 'in-out';
+}
+export interface WaveTransitionDirectionProps extends WaveTransitionBaseProps {
+    /**
+     * Slides the element from / towards the left.
+     * @property {boolean} left
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    left?: boolean;
+    /**
+     * Slides the element from / towards the right.
+     * @property {boolean} right
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    right?: boolean;
+    /**
+     * Slides the element from / towards the top.
+     * @property {boolean} up
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    up?: boolean;
+    /**
+     * Slides the element from / towards the bottom (default direction).
+     * @property {boolean} down
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    down?: boolean;
+}
+type DefaultSlot = SlotsType<{
+    /**
+     * The element or component to transition.
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    'default': () => any;
+}>;
+export type WTransitionFadeProps = WaveTransitionBaseProps;
+export type WTransitionFade = DefineComponent<WTransitionFadeProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionFadeProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionFadeProps>, DefaultSlot>;
+export type WTransitionScaleProps = WaveTransitionBaseProps;
+export type WTransitionScale = DefineComponent<WTransitionScaleProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionScaleProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionScaleProps>, DefaultSlot>;
+export type WTransitionScaleFadeProps = WaveTransitionBaseProps;
+export type WTransitionScaleFade = DefineComponent<WTransitionScaleFadeProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionScaleFadeProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionScaleFadeProps>, DefaultSlot>;
+export type WTransitionBounceProps = WaveTransitionBaseProps;
+export type WTransitionBounce = DefineComponent<WTransitionBounceProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionBounceProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionBounceProps>, DefaultSlot>;
+export type WTransitionTwistProps = WaveTransitionBaseProps;
+export type WTransitionTwist = DefineComponent<WTransitionTwistProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionTwistProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionTwistProps>, DefaultSlot>;
+export interface WTransitionExpandProps {
+    /**
+     * Animates the element's width (and its horizontal margins, paddings and borders).
+     * Defaults to `true` when neither `x` nor `y` is set.
+     * @property {boolean} x
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    x?: boolean;
+    /**
+     * Animates the element's height (and its vertical margins, paddings and borders).
+     * Defaults to `true` when neither `x` nor `y` is set.
+     * @property {boolean} y
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    y?: boolean;
+    /**
+     * Duration of the JavaScript-driven expand/collapse animation in milliseconds.
+     * @property {number} duration - Default: 250
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    duration?: number;
+    /**
+     * Controls the timing of enter/leave transitions when switching between two elements.
+     * Defaults to `'out-in'` so the collapsing element finishes before the expanding one starts.
+     * @property {'out-in' | 'in-out'} mode - Default: 'out-in'
+     * @see https://vuejs.org/guide/built-ins/transition.html#transition-modes
+     * @see https://antoniandre.github.io/wave-ui/transitions
+     */
+    mode?: 'out-in' | 'in-out';
+}
+export type WTransitionExpand = DefineComponent<WTransitionExpandProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionExpandProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionExpandProps>, DefaultSlot>;
+export type WTransitionSlideProps = WaveTransitionDirectionProps;
+export type WTransitionSlide = DefineComponent<WTransitionSlideProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionSlideProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionSlideProps>, DefaultSlot>;
+export type WTransitionSlideFadeProps = WaveTransitionDirectionProps;
+export type WTransitionSlideFade = DefineComponent<WTransitionSlideFadeProps, {}, {}, ComputedOptions, MethodOptions, {}, {}, EmitsOptions, string, PublicProps, ResolveProps<WTransitionSlideFadeProps, EmitsOptions>, ExtractDefaultPropTypes<WTransitionSlideFadeProps>, DefaultSlot>;
+export {};

package/dist/types/types/components/WTransitions.js

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

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

@@ -98,6 +98,13 @@ export interface WaveTreeProps {
      * @see https://antoniandre.github.io/wave-ui/w-tree
      */
     selectable?: boolean;
+    /**
+     * When `true`, disables the pointer ripple on selectable nodes for this tree only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-tree
+     */
+    noRipple?: boolean;
     /**
      * TODO: Add Description
      * @property {boolean} deepReactivity

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

@@ -1,6 +1,6 @@
 export { WAccordion } from './WAccordion';
 export { WAlert } from './WAlert';
-export { WApp } from './WApp';
+export { WAutocomplete, WAutocompleteItem } from './WAutocomplete';
 export { WBadge } from './WBadge';
 export { WBreadcrumbs } from './WBreadcrumbs';
 export { WButton } from './WButton';
@@ -41,3 +41,4 @@ export { WTimeline } from './WTimeline';
 export { WToolbar } from './WToolbar';
 export { WTooltip } from './WTooltip';
 export { WTree } from './WTree';
+export { WTransitionFade, WTransitionScale, WTransitionScaleFade, WTransitionBounce, WTransitionTwist, WTransitionExpand, WTransitionSlide, WTransitionSlideFade, type WaveTransitionBaseProps, type WaveTransitionDirectionProps, type WTransitionFadeProps, type WTransitionScaleProps, type WTransitionScaleFadeProps, type WTransitionBounceProps, type WTransitionTwistProps, type WTransitionExpandProps, type WTransitionSlideProps, type WTransitionSlideFadeProps } from './WTransitions';

package/dist/types/types/index.d.ts

@@ -2,4 +2,5 @@ import { WaveUIPlugin } from './plugin';
 export type * from './$waveui';
 export type * from './colors';
 export type * from './components';
+export type * from './mixins/detachable';
 export default WaveUIPlugin;

package/dist/types/types/mixins/detachable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * DetachableMixin adds this reactive field on `w-menu` and `w-tooltip`.
+ * It is internal — used so `<Teleport>` is omitted until `mounted()` for SSR/hydration parity (e.g. Nuxt).
+ */
+export interface WaveDetachableMixinInstance {
+    detachableDomReady: boolean;
+}

package/dist/types/types/mixins/detachable.js

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