primevue 3.8.1 → 3.10.0

package/knob/Knob.d.ts

@@ -1,23 +1,97 @@
-interface KnobProps {
-    modelValue?: number;
-    size?: number;
-    disabled?: boolean;
-    readonly?: boolean;
-    step?: number;
-    min?: number;
-    max?: number;
-    valueColor?: string;
-    rangeColor?: string;
-    textColor?: string;
-    strokeWidth?: number;
-    showValue?: boolean;
-    valueTemplate?: string;
+import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
+
+export interface KnobProps {
+    /**
+     * Value of the component.
+     */
+    modelValue?: number | undefined;
+    /**
+     * Size of the component in pixels.
+     * Default value is 100.
+     */
+    size?: number | undefined;
+    /**
+     * When present, it specifies that the component should be disabled.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * When present, it specifies that the component value cannot be edited.
+     */
+    readonly?: boolean | undefined;
+    /**
+     * Step factor to increment/decrement the value.
+     */
+    step?: number | undefined;
+    /**
+     * Mininum boundary value.
+     * Default value is 0.
+     */
+    min?: number | undefined;
+    /**
+     * Maximum boundary value.
+     * Default value is 100.
+     */
+    max?: number | undefined;
+    /**
+     * Background of the value.
+     */
+    valueColor?: string | undefined;
+    /**
+     * Background color of the range.
+     */
+    rangeColor?: string | undefined;
+    /**
+     * Color of the value text.
+     */
+    textColor?: string | undefined;
+    /**
+     * Width of the knob stroke.
+     * Default value is 14.
+     */
+    strokeWidth?: number | undefined;
+    /**
+     * Whether the show the value inside the knob.
+     * Default value is true.
+     */
+    showValue?: boolean | undefined;
+    /**
+     * Template string of the value.
+     * Default value is '{value}'.
+     */
+    valueTemplate?: string | undefined;
+}
+
+export interface KnobSlots {
 }
 
-declare class Knob {
-    $props: KnobProps;
-    $emit(eventName: 'update:modelValue', value: number): this;
-    $emit(eventName: 'change', value: any): this;
+export declare type KnobEmits = {
+    /**
+     * Emitted when the value changes.
+     * @param {number} value - New value.
+     */
+    'update:modelValue': (value: number) => void;
+    /**
+     * Callback to invoke when the value changes.
+     * @param {number} value - New value
+     */
+    'change': (value: number) => void;
+}
+
+declare class Knob extends ClassComponent<KnobProps, KnobSlots, KnobEmits> { }
+
+declare module '@vue/runtime-core' {
+    interface GlobalComponents {
+        Knob: GlobalComponentConstructor<Knob>
+    }
 }
 
+/**
+ *
+ * Knob is a form component to define number inputs with a dial.
+ *
+ * Demos:
+ *
+ * - [Knob](https://www.primefaces.org/primevue/showcase/#/knob)
+ *
+ */
 export default Knob;

package/listbox/Listbox.d.ts

@@ -1,44 +1,265 @@
 import { VNode } from 'vue';
-import { VirtualScrollerProps } from '../virtualscroller';
+import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
+import { VirtualScrollerProps, VirtualScrollerItemOptions } from '../virtualscroller';
 
-interface ListboxProps {
+
+type ListboxOptionLabelType = string | ((data: any) => string) | undefined;
+
+type ListboxOptionValueType = string | ((data: any) => any) | undefined;
+
+type ListboxOptionDisabledType = string | ((data: any) => boolean) | undefined;
+
+type ListboxOptionChildrenType = string | ((data: any) => any[]) | undefined;
+
+type ListboxFilterMatchModeType = 'contains' | 'startsWith' | 'endsWith' | undefined;
+
+export interface ListboxChangeEvent {
+    /**
+     * Original event
+     */
+    originalEvent: Event;
+    /**
+     * Selected option value
+     */
+    value: any;
+}
+
+export interface ListboxFilterEvent {
+    /**
+     * Original event
+     */
+    originalEvent: Event;
+    /**
+     * Filter value
+     */
+    value: string;
+}
+
+export interface ListboxProps {
+    /**
+     * Value of the component.
+     */
     modelValue?: any;
-    options?: any[];
-    optionLabel?: string;
-    optionValue?: any;
-    optionDisabled?: boolean;
-    optionGroupLabel?: string;
-    optionGroupChildren?: string;
-    listStyle?: string;
-    disabled?: boolean;
-    dataKey?: string;
-    multiple?: boolean;
-    metaKeySelection?: boolean;
-    filter?: boolean;
-    filterPlaceholder?: string;
-    filterLocale?: string;
-    filterMatchMode?: string;
-    filterFields?: string[];
-    emptyFilterMessage?: string;
-    emptyMessage?: string;
+    /**
+     * An array of selectitems to display as the available options.
+     */
+    options?: any[] | undefined;
+    /**
+     * Property name or getter function to use as the label of an option.
+     */
+    optionLabel?: ListboxOptionLabelType;
+    /**
+     * Property name or getter function to use as the value of an option, defaults to the option itself when not defined.
+     */
+    optionValue?: ListboxOptionValueType;
+    /**
+     * Property name or getter function to use as the disabled flag of an option, defaults to false when not defined.
+     */
+    optionDisabled?: ListboxOptionDisabledType;
+    /**
+     * Property name or getter function to use as the label of an option group.
+     */
+    optionGroupLabel?: ListboxOptionLabelType;
+    /**
+     * Property name or getter function that refers to the children options of option group.
+     */
+    optionGroupChildren?: ListboxOptionChildrenType;
+    /**
+     * Inline style of inner list element.
+     */
+    listStyle?: string | undefined;
+    /**
+     * When specified, disables the component.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * A property to uniquely identify an option.
+     */
+    dataKey?: string | undefined;
+    /**
+     * When specified, allows selecting multiple values.
+     */
+    multiple?: boolean | undefined;
+    /**
+     * Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually.
+     * On touch enabled devices, metaKeySelection is turned off automatically.
+     * Default value is true.
+     */
+    metaKeySelection?: boolean | undefined;
+    /**
+     * When specified, displays a filter input at header.
+     */
+    filter?: boolean | undefined;
+    /**
+     * Placeholder text to show when filter input is empty.
+     */
+    filterPlaceholder?: string | undefined;
+    /**
+     * Locale to use in filtering. The default locale is the host environment's current locale.
+     */
+    filterLocale?: string | undefined;
+    /**
+     * Defines the filtering algorithm to use when searching the options.
+     * @see ListboxFilterMatchModeType
+     * Default value is 'contains'.
+     */
+    filterMatchMode?: ListboxFilterMatchModeType;
+    /**
+     * Fields used when filtering the options, defaults to optionLabel.
+     */
+    filterFields?: string[] | undefined;
+    /**
+     * Text to display when filtering does not return any results. Defaults to value from PrimeVue locale configuration.
+     * Default value is 'No results found'.
+     */
+    emptyFilterMessage?: string | undefined;
+    /**
+     * Text to display when there are no options available. Defaults to value from PrimeVue locale configuration.
+     * Default value is 'No results found'.
+     */
+    emptyMessage?: string | undefined;
+    /**
+     * Whether to use the virtualScroller feature. The properties of VirtualScroller component can be used like an object in it.
+     * @see VirtualScroller.VirtualScrollerProps
+     */
     virtualScrollerOptions?: VirtualScrollerProps;
 }
 
-declare class Listbox {
-    $props: ListboxProps;
-    $emit(eventName: 'update:modelValue', value: any): this;
-    $emit(eventName: 'change', e: { originalEvent: Event, value: any }): this;
-    $emit(eventName: 'filter', e: { originalEvent: Event, value: string }): this;
-    $slots: {
-        header: VNode[];
-        footer: VNode[];
-        option: VNode[];
-        optiongroup: VNode[];
-        emptyfilter: VNode[];
-        empty: VNode[];
-        content: VNode[];
-        loader: VNode[];
+export interface ListboxSlots {
+    /**
+     * Custom header template.
+     * @param {Object} scope - header slot's params.
+     */
+    header: (scope: {
+        /**
+         * Value of the component
+         */
+        value: any;
+        /**
+         * Displayed options
+         */
+        options: any[];
+    }) => VNode[];
+    /**
+     * Custom footer template.
+     * @param {Object} scope - footer slot's params.
+     */
+    footer: (scope: {
+        /**
+         * Value of the component
+         */
+        value: any;
+        /**
+         * Displayed options
+         */
+        options: any[];
+    }) => VNode[];
+    /**
+     * Custom option template.
+     * @param {Object} scope - option slot's params.
+     */
+    option: (scope: {
+        /**
+         * Option instance
+         */
+        option: any;
+        /**
+         * Index of the option
+         */
+        index: number;
+    }) => VNode[];
+    /**
+     * Custom optiongroup template.
+     * @param {Object} scope - optiongroup slot's params.
+     */
+    optiongroup: (scope: {
+        /**
+         * Option instance
+         */
+        option: any;
+        /**
+         * Index of the option
+         */
+        index: number;
+    }) => VNode[];
+    /**
+     * Custom emptyfilter template.
+     */
+    emptyfilter: () => VNode[];
+    /**
+     * Custom empty template.
+     */
+    empty: () => VNode[];
+    /**
+     * Custom content template.
+     * @param {Object} scope - content slot's params.
+     */
+    content: (scope: {
+        /**
+         * An array of objects to display for virtualscroller
+         */
+        items: any;
+        /**
+         * Style class of the component
+         */
+        styleClass: string;
+        /**
+         * Referance of the content
+         * @param {HTMLElement} el - Element of 'ref' property
+         */
+        contentRef(el: any): void;
+        /**
+         * Options of the items
+         * @param {number} index - Rendered index
+         * @return {@link VirtualScroller.VirtualScrollerItemOptions}
+         */
+        getItemOptions(index: number): VirtualScrollerItemOptions;
+    }) => VNode[];
+    /**
+     * Custom loader template.
+     * @param {Object} scope - loader slot's params.
+     */
+    loader: (scope: {
+        /**
+         * Options of the loader items for virtualscroller
+         */
+        options: any[];
+    }) => VNode[];
+}
+
+export declare type ListboxEmits = {
+    /**
+     * Emitted when the value changes.
+     * @param {*} value - New value.
+     */
+    'update:modelValue': (value: any) => void;
+    /**
+     * Callback to invoke on value change.
+     * @param {ListboxChangeEvent} event - Custom change event.
+     */
+    'change': (event: ListboxChangeEvent) => void;
+    /**
+     * Callback to invoke on filter input.
+     * @param {ListboxFilterEvent} event - Custom filter event.
+     */
+    'filter': (event: ListboxFilterEvent) => void;
+}
+
+declare class Listbox extends ClassComponent<ListboxProps, ListboxSlots, ListboxEmits> { }
+
+declare module '@vue/runtime-core' {
+    interface GlobalComponents {
+        Listbox: GlobalComponentConstructor<Listbox>
     }
 }
 
+/**
+ *
+ * Listbox is used to select one or more values from a list of items.
+ *
+ * Demos:
+ *
+ * - [Listbox](https://www.primefaces.org/primevue/showcase/#/listbox)
+ *
+ */
 export default Listbox;

package/megamenu/MegaMenu.d.ts

@@ -1,18 +1,70 @@
 import { VNode } from 'vue';
+import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
+import { MenuItem } from '../menuitem';
 
-interface MegaMenuProps {
-    model?: any[];
-    orientation?: string;
-    exact?: boolean;
+type MegaMenuOrientationType = 'horizontal' | 'vertical' | undefined;
+
+export interface MegaMenuProps {
+    /**
+     * An array of menuitems.
+     */
+    model?: MenuItem[] | undefined;
+    /**
+     * Defines the orientation.
+     * @see MegaMenuOrientationType
+     * Default value is 'horizontal'.
+     */
+    orientation?: MegaMenuOrientationType;
+    /**
+     * Whether to apply 'router-link-active-exact' class if route exactly matches the item path.
+     * Default value is true.
+     */
+    exact?: boolean | undefined;
+}
+
+export interface MegaMenuSlots {
+    /**
+     * Custom start template.
+     */
+    start: () => VNode[];
+    /**
+     * Custom end template.
+     */
+    end: () => VNode[];
+    /**
+     * Custom item template.
+     * @param {Object} scope - item slot's params.
+     */
+    item: (scope: {
+        /**
+         * Menuitem instance
+         */
+        item: MenuItem;
+    }) => VNode[];
 }
 
-declare class MegaMenu {
-    $props: MegaMenuProps;
-    $slots: {
-        start: VNode[];
-        end: VNode[];
-        item: VNode[];
+export declare type MegaMenuEmits = {
+}
+
+declare class MegaMenu extends ClassComponent<MegaMenuProps, MegaMenuSlots, MegaMenuEmits> { }
+
+declare module '@vue/runtime-core' {
+    interface GlobalComponents {
+        MegaMenu: GlobalComponentConstructor<MegaMenu>
     }
 }
 
+/**
+ *
+ * MegaMenu is navigation component that displays submenus together.
+ *
+ * Helper API:
+ *
+ * - [MenuItem](https://www.primefaces.org/primevue/showcase/#/menumodel)
+ *
+ * Demos:
+ *
+ * - [MegaMenu](https://www.primefaces.org/primevue/showcase/#/megamenu)
+ *
+ */
 export default MegaMenu;

package/megamenu/MegaMenu.vue

@@ -4,41 +4,41 @@
             <slot name="start"></slot>
         </div>
         <ul class="p-megamenu-root-list" role="menubar">
-            <template v-for="(category,index) of model" :key="category.label + '_' + index">
+            <template v-for="(category,index) of model" :key="label(category) + '_' + index">
                 <li v-if="visible(category)"  :class="getCategoryClass(category)" :style="category.style"
                     @mouseenter="onCategoryMouseEnter($event, category)" role="none">
                     <template v-if="!$slots.item">
                         <router-link v-if="category.to && !disabled(category)" :to="category.to" custom v-slot="{navigate, href, isActive, isExactActive}">
                             <a :href="href" :class="linkClass(category, {isActive, isExactActive})" @click="onCategoryClick($event, category, navigate)" @keydown="onCategoryKeydown($event, category)" role="menuitem" v-ripple>
                                 <span v-if="category.icon" :class="getCategoryIcon(category)"></span>
-                                <span class="p-menuitem-text">{{category.label}}</span>
+                                <span class="p-menuitem-text">{{label(category)}}</span>
                             </a>
                         </router-link>
                         <a v-else :href="category.url" :class="linkClass(category)" :target="category.target" @click="onCategoryClick($event, category)" @keydown="onCategoryKeydown($event, category)"
                             role="menuitem" :aria-haspopup="category.items != null" :aria-expanded="category === activeItem" :tabindex="disabled(category) ? null : '0'" v-ripple>
                             <span v-if="category.icon" :class="getCategoryIcon(category)"></span>
-                            <span class="p-menuitem-text">{{category.label}}</span>
+                            <span class="p-menuitem-text">{{label(category)}}</span>
                             <span v-if="category.items" :class="getCategorySubMenuIcon()"></span>
                         </a>
                     </template>
-                    <component v-else :is="$slots.item" :item="item"></component>
+                    <component v-else :is="$slots.item" :item="category"></component>
                     <div class="p-megamenu-panel" v-if="category.items">
                         <div class="p-megamenu-grid">
-                            <div v-for="(column,columnIndex) of category.items" :key="category.label + '_column_' + columnIndex" :class="getColumnClassName(category)">
+                            <div v-for="(column,columnIndex) of category.items" :key="label(category) + '_column_' + columnIndex" :class="getColumnClassName(category)">
                                 <ul v-for="(submenu,submenuIndex) of column" class="p-megamenu-submenu" :key="submenu.label + '_submenu_' + submenuIndex" role="menu">
                                     <li :class="getSubmenuHeaderClass(submenu)" :style="submenu.style" role="presentation">{{submenu.label}}</li>
-                                    <template v-for="(item, i) of submenu.items" :key="item.label + i.toString()">
+                                    <template v-for="(item, i) of submenu.items" :key="label(item) + i.toString()">
                                         <li role="none" :class="getSubmenuItemClass(item)" :style="item.style" v-if="visible(item) && !item.separator">
                                             <template v-if="!$slots.item">
                                                 <router-link v-if="item.to && !disabled(item)" :to="item.to" custom v-slot="{navigate, href, isActive, isExactActive}">
                                                     <a :href="href" :class="linkClass(item, {isActive, isExactActive})" @click="onLeafClick($event, item, navigate)" role="menuitem" v-ripple>
                                                         <span v-if="item.icon" :class="['p-menuitem-icon', item.icon]"></span>
-                                                        <span class="p-menuitem-text">{{item.label}}</span>
+                                                        <span class="p-menuitem-text">{{label(item)}}</span>
                                                     </a>
                                                 </router-link>
                                                 <a v-else :href="item.url" :class="linkClass(item)" :target="item.target" @click="onLeafClick($event, item)" role="menuitem" :tabindex="disabled(item) ? null : '0'" v-ripple>
                                                     <span v-if="item.icon" :class="['p-menuitem-icon', item.icon]"></span>
-                                                    <span class="p-menuitem-text">{{item.label}}</span>
+                                                    <span class="p-menuitem-text">{{label(item)}}</span>
                                                     <span :class="getSubmenuIcon()" v-if="item.items"></span>
                                                 </a>
                                             </template>
@@ -308,6 +308,9 @@ export default {
         },
         disabled(item) {
             return (typeof item.disabled === 'function' ? item.disabled() : item.disabled);
+        },
+        label(item) {
+            return (typeof item.disabled === 'function' ? item.label() : item.label);
         }
     },
     computed: {

package/megamenu/megamenu.cjs.js

@@ -250,6 +250,9 @@ var script = {
         },
         disabled(item) {
             return (typeof item.disabled === 'function' ? item.disabled() : item.disabled);
+        },
+        label(item) {
+            return (typeof item.disabled === 'function' ? item.label() : item.label);
         }
     },
     computed: {
@@ -306,7 +309,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
     vue.createVNode("ul", _hoisted_2, [
       (vue.openBlock(true), vue.createBlock(vue.Fragment, null, vue.renderList($props.model, (category, index) => {
         return (vue.openBlock(), vue.createBlock(vue.Fragment, {
-          key: category.label + '_' + index
+          key: $options.label(category) + '_' + index
         }, [
           ($options.visible(category))
             ? (vue.openBlock(), vue.createBlock("li", {
@@ -338,7 +341,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                                       class: $options.getCategoryIcon(category)
                                     }, null, 2))
                                   : vue.createCommentVNode("", true),
-                                vue.createVNode("span", _hoisted_3, vue.toDisplayString(category.label), 1)
+                                vue.createVNode("span", _hoisted_3, vue.toDisplayString($options.label(category)), 1)
                               ], 42, ["href", "onClick", "onKeydown"]), [
                                 [_directive_ripple]
                               ])
@@ -363,7 +366,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                                   class: $options.getCategoryIcon(category)
                                 }, null, 2))
                               : vue.createCommentVNode("", true),
-                            vue.createVNode("span", _hoisted_4, vue.toDisplayString(category.label), 1),
+                            vue.createVNode("span", _hoisted_4, vue.toDisplayString($options.label(category)), 1),
                             (category.items)
                               ? (vue.openBlock(), vue.createBlock("span", {
                                   key: 1,
@@ -376,14 +379,14 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                     ], 64))
                   : (vue.openBlock(), vue.createBlock(vue.resolveDynamicComponent(_ctx.$slots.item), {
                       key: 1,
-                      item: _ctx.item
+                      item: category
                     }, null, 8, ["item"])),
                 (category.items)
                   ? (vue.openBlock(), vue.createBlock("div", _hoisted_5, [
                       vue.createVNode("div", _hoisted_6, [
                         (vue.openBlock(true), vue.createBlock(vue.Fragment, null, vue.renderList(category.items, (column, columnIndex) => {
                           return (vue.openBlock(), vue.createBlock("div", {
-                            key: category.label + '_column_' + columnIndex,
+                            key: $options.label(category) + '_column_' + columnIndex,
                             class: $options.getColumnClassName(category)
                           }, [
                             (vue.openBlock(true), vue.createBlock(vue.Fragment, null, vue.renderList(column, (submenu, submenuIndex) => {
@@ -399,7 +402,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                                 }, vue.toDisplayString(submenu.label), 7),
                                 (vue.openBlock(true), vue.createBlock(vue.Fragment, null, vue.renderList(submenu.items, (item, i) => {
                                   return (vue.openBlock(), vue.createBlock(vue.Fragment, {
-                                    key: item.label + i.toString()
+                                    key: $options.label(item) + i.toString()
                                   }, [
                                     ($options.visible(item) && !item.separator)
                                       ? (vue.openBlock(), vue.createBlock("li", {
@@ -429,7 +432,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                                                                 class: ['p-menuitem-icon', item.icon]
                                                               }, null, 2))
                                                             : vue.createCommentVNode("", true),
-                                                          vue.createVNode("span", _hoisted_7, vue.toDisplayString(item.label), 1)
+                                                          vue.createVNode("span", _hoisted_7, vue.toDisplayString($options.label(item)), 1)
                                                         ], 10, ["href", "onClick"]), [
                                                           [_directive_ripple]
                                                         ])
@@ -451,7 +454,7 @@ function render(_ctx, _cache, $props, $setup, $data, $options) {
                                                             class: ['p-menuitem-icon', item.icon]
                                                           }, null, 2))
                                                         : vue.createCommentVNode("", true),
-                                                      vue.createVNode("span", _hoisted_8, vue.toDisplayString(item.label), 1),
+                                                      vue.createVNode("span", _hoisted_8, vue.toDisplayString($options.label(item)), 1),
                                                       (item.items)
                                                         ? (vue.openBlock(), vue.createBlock("span", {
                                                             key: 1,