npm - kempo-ui - Versions diffs - 0.4.19 → 0.4.20 - Mend

@@ -1,136 +0,0 @@
-# 0006 - Create Pagination Component
-## Status: Complete
-## Dependency
-None
-## References
-[styles](file:///c:\Users\dusti\.copilot\skills\styles\SKILL.md) - global skill for properly styling the component
-[component-code](file:///c:\Users\dusti\.copilot\skills\component-code\SKILL.md) - global skill for coding kempo-ui components
-[MarkdownEditor](../src/components/MarkdownEditor.js) - similar component pattern with control variants and preconfigured controls showing how to structure controls, make them interact with the primary component, and implement preconfigured control combinations
-## Current State
-No pagination component exists yet. Pagination functionality is not available to users.
-## Aceptance Criteria
-A new Pagination component should be created that:
-- Acts as a UI interface component placed under content
-- Does not manage the actual content being paginated
-- Accepts attributes for total number of items, items per page, and current page number
-- Calculates total number of pages from total items and items per page
-- Displays and tracks the current page number
-- Exposes public methods: `nextPage()`, `previousPage()`
-- Allows direct page assignment via the `page` property with automatic clamping
-- Emits `page-change` event when the user navigates to a different page
-- Emits `items-per-page-change` event when the items-per-page configuration changes
-- Has separate control components for common pagination controls (like HtmlEditor pattern)
-- Includes preconfigured control variants for common use cases
-### In-Scope
-- `src/components/pagination.js` - main component
-- `src/components/pagination-controls-*.js` - control component variants
-- `docs-src/components/pagination.page.html` - documentation page
-- `tests/components/pagination.test.js` - component tests
-### Out of Scope
-- Modifications to existing components
-- Backend pagination logic or data fetching
-- Content management or rendering within the pagination component itself
-## Task Details
-1. Set up the Pagination component using the component-setup skill
-2. Implement the base Pagination component with:
-   - Attributes: `totalItems` (total number of items), `itemsPerPage` (items per page), and `page` (current page)
-   - Getter properties: `totalPages` (calculated from totalItems and itemsPerPage)
-   - `page` property with automatic clamping to [1, totalPages] range
-   - Internal tracking of current page (default to page 1)
-   - Display of page information (e.g., "Page 3 of 10")
-   - Public methods: `nextPage()`, `previousPage()` (automatically clamped)
-   - `page-change` event emission when user navigates (not fired on auto-resets)
-   - `items-per-page-change` event emission when items-per-page changes
-   - Event detail includes full pagination state
-3. Create pagination control component variants following the HtmlEditor control pattern
-4. Create preconfigured pagination control combinations
-5. Write component tests covering all functionality
-6. Create documentation page with examples
-7. Update `llms.txt` with new component
-## Testing / Validation Plan
-- Verify component renders correctly with various page counts and items per page values
-- Test direct page assignment (`el.page = n`) sets the correct page with automatic clamping
-- Test `nextPage()` increments page and disables when at last page
-- Test `previousPage()` decrements page and disables when at first page
-- Verify `page-change` event fires only when user navigates (not on auto-resets)
-- Verify `items-per-page-change` event fires when itemsPerPage changes
-- Verify event details include full pagination state
-- Verify control components render and function correctly
-- Verify preconfigured controls work as expected
-- Test with browser DevTools to confirm no console errors
-### Testing / Validation Results
-#### LLM Validation Results
-##### Component renders correctly with various page counts and items per page
-**PASS.** The documentation page shows `<k-pagination>` working at 100 total items / 10 per page (10 pages) and 47 total items / 10 per page (5 pages). The `totalPages` getter returns the correct ceiling division in both cases. The page info text ("Page 1 of 10", "Page 1 of 5") reflects the correct state.
-![Top of docs page — basic usage and With Controls](0006-create-pagination-component/screenshot-01-top.png)
-![Controls sections — Simple and Full preconfigured](0006-create-pagination-component/screenshot-02-controls.png)
-##### setPage() sets the correct page and emits event
-**PASS.** The `page` property can be set directly (e.g. `el.page = 3`) and automatically clamps out-of-range values to [1, totalPages]. The `page-change` event fires only when the page actually changes (not during auto-resets). The event detail includes `{ currentPage, totalPages, itemsPerPage, totalItems }`.
-##### nextPage() increments page and disables when at last page
-**PASS.** In the live demo, clicking Next advanced cards from Items 1–10 (page 1) to Items 11–20 (page 2). On the last page (page 5, Items 41–47), the Next and Last buttons are correctly disabled.
-![Live demo page 1 — Items 1–10](0006-create-pagination-component/screenshot-04-live-demo-page1.png)
-![Live demo page 2 — Items 11–20 after clicking Next](0006-create-pagination-component/screenshot-05-live-demo-page2.png)
-![Live demo last page — Items 41–47, Next/Last buttons disabled](0006-create-pagination-component/screenshot-06-live-demo-last-page.png)
-##### previousPage() decrements page and disables when at first page
-**PASS.** On page 1, the Previous and First buttons are disabled (confirmed in screenshots). Unit tests verify previousPage() decrements correctly and is a no-op at page 1.
-##### Events are properly emitted on all page changes
-**PASS.** The `page-change` event fires when the user navigates (via direct page assignment, `nextPage()`, or `previousPage()`), but NOT when the page auto-resets due to configuration changes. The `items-per-page-change` event fires when `itemsPerPage` changes. The live demo re-renders cards on every `page-change` event. Unit tests (all 2157 pass) verify both events fire correctly and do NOT fire inappropriately.
-##### Control components render and function correctly
-**PASS.** All six original controls (`k-pg-first`, `k-pg-prev`, `k-pg-page-info`, `k-pg-next`, `k-pg-last`, `k-pg-items-per-page`) plus two new controls (`k-pg-goto-page`, `k-pg-count`) render and respond to pagination state. Icons use `chevron` and `chevron-line` with the `direction` attribute for correct orientation.
-![Goto Page and All Controls sections](0006-create-pagination-component/screenshot-03-preconfigured.png)
-##### Preconfigured controls work as expected
-**PASS.** `controls="simple"` renders prev/page-info/next. `controls="full"` renders first/prev/page-info/next/last/items-per-page. All control modules are dynamically imported automatically when the `controls` attribute is set.
-##### No console errors
-**PASS.** The only 404s logged are for icon files at the relative `./icons/` path (e.g. `/components/icons/chevron.svg`) — this is the expected first-attempt behavior of the Icon component's fallback lookup system, which then succeeds at `/icons/chevron.svg`. The same pattern appears on every page of the docs. No JavaScript errors or unexpected failures.
-##### Unit tests
-**PASS.** All 2157 tests pass (includes 25+ Pagination-specific tests covering page navigation, clamping, direct assignment, event separation, and control rendering).
-```
-=== Test Summary ====
-Total Tests: 2157
-Passed: 2157
-Failed: 0
-All tests passed!
-```
-![JS Reference table](0006-create-pagination-component/screenshot-07-js-reference.png)
-#### User Validation Results
-I (Dustin Poissant) have validated this is all working as expected (see notes above).

@@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 ## [Unreleased]
+## [0.4.19] - 2026-05-06
 ### Added
 - **Pagination component** (`<k-pagination>`): Full-featured pagination with composable control sub-components
   - `page` attribute reflects and controls the current page number (defaults to 1)

@@ -1,6 +1,6 @@
 {
   "name": "kempo-ui",
-  "version": "0.4.19",
+  "version": "0.4.20",
   "type": "module",
   "description": "A Lit based web-component library",
   "main": "index.js",

kempo-ui 0.4.19 → 0.4.20