wave-ui 3.27.1 → 3.28.0

package/dist/types/types/$waveui.d.ts

@@ -202,6 +202,12 @@ export interface $waveui {
              */
             transition: false | 'default' | 'bounce' | 'scale' | 'twist' | 'fade' | 'slide-fade-left' | 'slide-fade-right' | 'slide-fade-up' | 'slide-fade-down';
         };
+        /**
+         * Default pointer ripple for supported components and for `v-wave-ripple` when the binding is not `false`.
+         * @property {boolean} ripple - Default: true
+         * @see https://antoniandre.github.io/wave-ui/options-presets-and-waveui
+         */
+        ripple: boolean;
         /**
          * Component presets
          * @property presets

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

@@ -146,6 +146,13 @@ export interface WaveAccordionProps {
      * @see https://antoniandre.github.io/wave-ui/w-accordion
      */
     keepInDom?: boolean;
+    /**
+     * When `true`, disables the accordion title pointer ripple for all items.
+     * Global default still follows `$waveui.config.ripple`. Per-item override: set `no-ripple` on `w-accordion-item`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-accordion
+     */
+    noRipple?: boolean;
 }
 export interface WaveAccordionEmits {
     /**

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

@@ -80,6 +80,13 @@ export interface WaveBreadcrumbsProps {
      * @see https://antoniandre.github.io/wave-ui/w-breadcrumbs
      */
     xl?: boolean;
+    /**
+     * When `true`, disables the pointer ripple on link items for this breadcrumbs only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-breadcrumbs
+     */
+    noRipple?: boolean;
 }
 export type WaveBreadcrumbsEmits = {};
 export interface WaveBreadcrumbsComputeds extends ComputedOptions {

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

@@ -196,6 +196,13 @@ export interface WaveButtonProps {
      * @see https://antoniandre.github.io/wave-ui/w-button
      */
     xl?: boolean;
+    /**
+     * When `true`, disables the pointer ripple on this button only.
+     * Global default still follows `$waveui.config.ripple`.
+     * @property {boolean} noRipple
+     * @see https://antoniandre.github.io/wave-ui/w-button
+     */
+    noRipple?: boolean;
 }
 export type WaveButtonEmits = {};
 export interface WaveButtonComputeds extends ComputedOptions {

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

@@ -27,6 +27,7 @@ export { WProgress } from './WProgress';
 export { WRadio } from './WRadio';
 export { WRadios } from './WRadios';
 export { WRating } from './WRating';
+export { WScrollable, type WaveScrollableScrollbar, type WaveScrollableScrollPayload, type WaveScrollableScrollPosition, type WaveScrollableScrollPositionInput, type WaveScrollableScrollSource } from './WScrollable';
 export { WSelect, WSelectDropdownItem } from './WSelect';
 export { WSlider } from './WSlider';
 export { WSpinner } from './WSpinner';