@waggylabs/yumekit 0.5.0-beta.74 → 0.5.0-beta.76

package/CHANGELOG.md

@@ -51,6 +51,8 @@ Delete any empty sections before publishing.
 
 - New `y-masonry` component — layout container that packs children of varying heights into the shortest column.
 
+- New `y-paginator` component — page navigation control with a configurable button window.
+
 ### Changed
 
 - **Icon rename — `comp-*` prefix dropped.** All 26 component-illustrating icons renamed. Two resolved collisions: `comp-menu` → `droplist` and `comp-tag` → `chip`.

package/dist/components/y-paginator/y-paginator.d.ts

@@ -0,0 +1,86 @@
+export class YumePaginator extends HTMLElement {
+    static get observedAttributes(): string[];
+    _onKeydown(e: any): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: any, oldValue: any, newValue: any): void;
+    set boundaryCount(v: number);
+    /** Number of boundary pages always shown at each end. */
+    get boundaryCount(): number;
+    set currentPage(v: number);
+    /**
+     * Currently active page (1-indexed). Clamped to [1, totalPages] when
+     * totalPages >= 1; returns 0 (the unset/no-data sentinel) when
+     * totalPages is 0.
+     */
+    get currentPage(): number;
+    set disabled(v: boolean);
+    /** When set, all interactive controls are inert. */
+    get disabled(): boolean;
+    set hideOnSinglePage(v: boolean);
+    /** When set, the component renders nothing if `totalPages <= 1`. */
+    get hideOnSinglePage(): boolean;
+    set itemsPerPage(v: number);
+    /**
+     * Currently selected items-per-page value. Returns `null` when the
+     * attribute is unset or not numeric.
+     */
+    get itemsPerPage(): number;
+    set pageCount(v: number);
+    /** Maximum number of page buttons displayed at once (excluding ellipses). */
+    get pageCount(): number;
+    set pageSizeLabel(v: string);
+    /** Label rendered next to the items-per-page select. */
+    get pageSizeLabel(): string;
+    set pageSizeOptions(v: any[]);
+    /**
+     * Available items-per-page choices. Accepts a JSON array of numbers
+     * (e.g. `[10, 25, 50]`) or `{ value, label }` objects. Returns `[]` when
+     * unset or invalid; the items-per-page select is only rendered when at
+     * least one option is available.
+     */
+    get pageSizeOptions(): any[];
+    set size(v: string);
+    /** Controls button size, font size, and spacing. */
+    get size(): string;
+    set totalPages(v: number);
+    /** Total number of pages. `0` indicates no data. */
+    get totalPages(): number;
+    set variant(v: string);
+    /** Visual style — `default`, `compact`, or `detailed` (with prev/next labels). */
+    get variant(): string;
+    /** Programmatically jump to a page. Honors event cancellation. */
+    goTo(page: any): void;
+    /** Advance to the next page. */
+    next(): void;
+    /** Return to the previous page. */
+    previous(): void;
+    /** Programmatically change items-per-page. Honors event cancellation. */
+    setPageSize(value: any): void;
+    _buildButton(page: any, { isCurrent, isDisabled }: {
+        isCurrent: any;
+        isDisabled: any;
+    }): HTMLElement;
+    _buildEllipsis(key: any): HTMLElement;
+    _buildList(items: any, current: any, isHostDisabled: any): HTMLElement;
+    _buildNavButton(direction: any, current: any, total: any, isHostDisabled: any): HTMLElement;
+    _navIsEdge(direction: any, current: any, total: any): boolean;
+    _navTargetPage(direction: any, current: any, total: any): any;
+    _buildCompactNav(wrapper: any, current: any, total: any, isHostDisabled: any): void;
+    _buildCompactStatus(current: any, total: any): HTMLElement;
+    _buildDefaultNav(wrapper: any, current: any, total: any, isHostDisabled: any): void;
+    _buildPageSizeSelect(): HTMLElement;
+    _buildStyles(): string;
+    _getPageList(current: any, total: any, pageCount: any, boundaryCount: any): any[];
+    _dedupe(items: any): any[];
+    _focusableButtons(): Element[];
+    _focusYButton(yBtn: any): void;
+    _focusFirstButton(): void;
+    _focusLastButton(): void;
+    _stepFocus(currentBtn: any, offset: any): void;
+    _onPageClick(page: any): void;
+    _range(start: any, end: any): any[];
+    _render(): void;
+    _requestPageSizeChange(nextSize: any): void;
+    _requestPageChange(nextPage: any): void;
+}

package/dist/components/y-paginator.d.ts

@@ -0,0 +1,86 @@
+export class YumePaginator extends HTMLElement {
+    static get observedAttributes(): string[];
+    _onKeydown(e: any): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: any, oldValue: any, newValue: any): void;
+    set boundaryCount(v: number);
+    /** Number of boundary pages always shown at each end. */
+    get boundaryCount(): number;
+    set currentPage(v: number);
+    /**
+     * Currently active page (1-indexed). Clamped to [1, totalPages] when
+     * totalPages >= 1; returns 0 (the unset/no-data sentinel) when
+     * totalPages is 0.
+     */
+    get currentPage(): number;
+    set disabled(v: boolean);
+    /** When set, all interactive controls are inert. */
+    get disabled(): boolean;
+    set hideOnSinglePage(v: boolean);
+    /** When set, the component renders nothing if `totalPages <= 1`. */
+    get hideOnSinglePage(): boolean;
+    set itemsPerPage(v: number);
+    /**
+     * Currently selected items-per-page value. Returns `null` when the
+     * attribute is unset or not numeric.
+     */
+    get itemsPerPage(): number;
+    set pageCount(v: number);
+    /** Maximum number of page buttons displayed at once (excluding ellipses). */
+    get pageCount(): number;
+    set pageSizeLabel(v: string);
+    /** Label rendered next to the items-per-page select. */
+    get pageSizeLabel(): string;
+    set pageSizeOptions(v: any[]);
+    /**
+     * Available items-per-page choices. Accepts a JSON array of numbers
+     * (e.g. `[10, 25, 50]`) or `{ value, label }` objects. Returns `[]` when
+     * unset or invalid; the items-per-page select is only rendered when at
+     * least one option is available.
+     */
+    get pageSizeOptions(): any[];
+    set size(v: string);
+    /** Controls button size, font size, and spacing. */
+    get size(): string;
+    set totalPages(v: number);
+    /** Total number of pages. `0` indicates no data. */
+    get totalPages(): number;
+    set variant(v: string);
+    /** Visual style — `default`, `compact`, or `detailed` (with prev/next labels). */
+    get variant(): string;
+    /** Programmatically jump to a page. Honors event cancellation. */
+    goTo(page: any): void;
+    /** Advance to the next page. */
+    next(): void;
+    /** Return to the previous page. */
+    previous(): void;
+    /** Programmatically change items-per-page. Honors event cancellation. */
+    setPageSize(value: any): void;
+    _buildButton(page: any, { isCurrent, isDisabled }: {
+        isCurrent: any;
+        isDisabled: any;
+    }): HTMLElement;
+    _buildEllipsis(key: any): HTMLElement;
+    _buildList(items: any, current: any, isHostDisabled: any): HTMLElement;
+    _buildNavButton(direction: any, current: any, total: any, isHostDisabled: any): HTMLElement;
+    _navIsEdge(direction: any, current: any, total: any): boolean;
+    _navTargetPage(direction: any, current: any, total: any): any;
+    _buildCompactNav(wrapper: any, current: any, total: any, isHostDisabled: any): void;
+    _buildCompactStatus(current: any, total: any): HTMLElement;
+    _buildDefaultNav(wrapper: any, current: any, total: any, isHostDisabled: any): void;
+    _buildPageSizeSelect(): HTMLElement;
+    _buildStyles(): string;
+    _getPageList(current: any, total: any, pageCount: any, boundaryCount: any): any[];
+    _dedupe(items: any): any[];
+    _focusableButtons(): Element[];
+    _focusYButton(yBtn: any): void;
+    _focusFirstButton(): void;
+    _focusLastButton(): void;
+    _stepFocus(currentBtn: any, offset: any): void;
+    _onPageClick(page: any): void;
+    _range(start: any, end: any): any[];
+    _render(): void;
+    _requestPageSizeChange(nextSize: any): void;
+    _requestPageChange(nextPage: any): void;
+}