From 3f4a7f168a9d7c53ad0fc79b1eb0cabca6421f92 Mon Sep 17 00:00:00 2001
From: mertsincan <sincan.mert@gmail.com>
Date: Wed, 1 Dec 2021 16:59:49 +0300
Subject: [PATCH] Fixed #1836 - For Paginator

---
 src/components/paginator/Paginator.d.ts | 160 +++++++++++++++++++-----
 1 file changed, 131 insertions(+), 29 deletions(-)

diff --git a/src/components/paginator/Paginator.d.ts b/src/components/paginator/Paginator.d.ts
index c70b22719..8cf46eb31 100755
--- a/src/components/paginator/Paginator.d.ts
+++ b/src/components/paginator/Paginator.d.ts
@@ -1,38 +1,140 @@
+import { VNode } from 'vue';
+import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
+
 export interface PageState {
-    first: number,
-    rows: number,
-    page: number,
-    pageCount: number
+    /**
+     * Index of first record
+     */
+    first: number;
+    /**
+     * Number of rows to display in new page
+     */
+    rows: number;
+    /**
+     * New page number
+     */
+    page: number;
+    /**
+     * Total number of pages
+     */
+    pageCount?: number;
 }
 
-interface PaginatorProps {
-    totalRecords?: number;
-    rows?: number;
-    first?: number;
-    pageLinkSize?: number;
-    rowsPerPageOptions?: any[];
-    template?: string;
-    currentPageReportTemplate?: any;
-    alwaysShow?: boolean;
+export interface PaginatorProps {
+    /**
+     * Number of total records.
+     * Default value is 0.
+     */
+    totalRecords?: number | undefined;
+    /**
+     * Data count to display per page.
+     * Default value is 0.
+     */
+    rows?: number | undefined;
+    /**
+     * Zero-relative number of the first row to be displayed.
+     * Default value is 0.
+     */
+    first?: number | undefined;
+    /**
+     * Number of page links to display.
+     * Default value is 5.
+     */
+    pageLinkSize?: number | undefined;
+    /**
+     * Array of integer values to display inside rows per page dropdown.
+     */
+    rowsPerPageOptions?: number[] | undefined;
+    /**
+     * Template of the paginator. It can be customized using the template property using the predefined keys, default value is "FirstPageLink PrevPageLink PageLinks NextPageLink LastPageLink RowsPerPageDropdown". Here are the available elements that can be placed inside a paginator in any order.
+     *
+     * - FirstPageLink
+     * - PrevPageLink
+     * - PageLinks
+     * - NextPageLink
+     * - LastPageLink
+     * - RowsPerPageDropdown
+     * - JumpToPageDropdown
+     * - JumpToPageInput
+     * - CurrentPageReport
+     */
+    template?: string | undefined;
+    /**
+     * Template of the current page report element. It displays information about the pagination state. Default value is ({currentPage} of {totalPages}) whereas available placeholders are the following;
+     *
+     * - {currentPage}
+     * - {totalPages}
+     * - {rows}
+     * - {first}
+     * - {last}
+     * - {totalRecords}
+     */
+    currentPageReportTemplate?: string | undefined;
+    /**
+     * Whether to show the paginator even there is only one page.
+     * Default value is true.
+     */
+    alwaysShow?: boolean | undefined;
 }
 
-interface PaginatorSlotInterface {
-    currentState: {
-        page: number;
-        first: number;
-        rows: number;
-    }
-}
-
-declare class Paginator {
-    $props: PaginatorProps;
-    $emit(eventName: 'update:first', value: number): this;
-    $emit(eventName: 'update:rows', value: number): this;
-    $emit(eventName: 'page', event: PageState): this;
-    $slots: {
-        left: PaginatorSlotInterface;
-        right: PaginatorSlotInterface;
+export interface PaginatorSlots {
+    /**
+     * Custom start template.
+     * @param {Object} scope - start slot's params.
+     */
+    start: (scope: {
+        /**
+         * Current state
+         * @see PageState
+         */
+        currentState: PageState;
+    }) => VNode[];
+    /**
+     * Custom end template.
+     * @param {Object} scope - end slot's params.
+     */
+    end: (scope: {
+        /**
+         * Current state
+         * @see PageState
+         */
+        currentState: PageState;
+    }) => VNode[];
+}
+
+export declare type PaginatorEmits = {
+    /**
+     * Emitted when the first changes.
+     * @param {number} value - New value.
+     */
+    'update:first': (value: number) => void;
+    /**
+     * Emitted when the rows changes.
+     * @param {number} value - New value.
+     */
+    'update:rows': (value: number) => void;
+    /**
+     * Callback to invoke when page changes, the event object contains information about the new state.
+     * @param {PageState} event - New page state.
+     */
+    'page': (event: PageState) => void;
+}
+
+declare class Paginator extends ClassComponent<PaginatorProps, PaginatorSlots, PaginatorEmits> { }
+
+declare module '@vue/runtime-core' {
+    interface GlobalComponents {
+        Paginator: GlobalComponentConstructor<Paginator>
     }
 }
 
+/**
+ *
+ * Paginator is a generic component to display content in paged format.
+ *
+ * Demos:
+ *
+ * - [Paginator](https://www.primefaces.org/primevue/showcase/#/paginator)
+ *
+ */
 export default Paginator;