ngxsmk-datepicker 2.2.3 → 2.2.8

package/README.md

@@ -24,15 +24,15 @@
 
 ---
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ### **Overview**
 
 **ngxsmk-datepicker** is a high-performance, enterprise-ready date and range picker engineered for the modern Angular ecosystem (v17+). Built from the ground up with **Angular Signals**, it delivers a seamless, zoneless-ready experience for both desktop and mobile (Ionic) applications.
 
-> **Stable Release**: `v2.2.3` is live! This release brings a **TypeScript Strictness Overhaul** (eliminating `any` types), **Cognitive Complexity & Linting Fixes** for Material integration, and improved **Test Coverage (~68.2%)**. It also fixes **appendToBody** popover positioning, datepicker-in-modal behavior, and touch interaction regressions. No breaking changes.
+> **Stable Release**: `v2.2.8` restores correct **npm** artifacts (compiled `fesm2022/` and types), adds range-mode **`allowSameDay`** for single-day selections, and continues to ship **IANA timezone** support, validation fixes, and strict TypeScript improvements from the v2.2.x line.
 >
-> ⚠️ **Important**: Versions 2.0.10 and 2.0.11 are broken and have been unpublished. Please use v2.2.3 or later.
+> ⚠️ **Important**: Versions 2.0.10 and 2.0.11 are broken and have been unpublished. Please use v2.2.8 or later.
 
 ---
 
@@ -590,7 +590,7 @@ The `locale` input controls all internationalization. It automatically formats m
 
 ### **Global Language Support**
 
-ngxsmk-datepicker v2.2.3 now features **full localization synchronization** for:
+ngxsmk-datepicker v2.2.8 now features **full localization synchronization** for:
 
 - 🇺🇸 English (`en`)
 - 🇩🇪 German (`de`)
@@ -683,8 +683,11 @@ This library has been optimized for maximum performance:
 
 ## **🐛 Bug Fixes & Improvements**
 
-### **Critical Updates in v2.2.3:**
+### **Critical Updates in v2.2.6:**
 
+- ✅ **Timezone Support**: Added full support for IANA timezones in "Today" calculation.
+- ✅ **Date Validation**: Fixed "Today" unselectable bug by normalizing `minDate` boundary checks.
+- ✅ **Keyboard Shortcuts**: Updated "Today" selection shortcut to use timezone-aware calculation.
 - ✅ **Validation messages**: User-facing i18n strings for invalid date, min/max; `validationError` output and on-screen error display
 - ✅ **Calendar loading state**: Visual spinner + text and screen-reader announcement while calendar opens/generates
 - ✅ **Demo theme**: Light/dark theme toggle and system preference now correctly switch the demo UI
@@ -846,16 +849,17 @@ We welcome and appreciate contributions from the community! Whether it's reporti
 
 For a full list of changes, please refer to the [CHANGELOG.md](https://github.com/NGXSMK/ngxsmk-datepicker/blob/main/CHANGELOG.md) file.
 
-### **v2.2.3** (Current Stable)
+### **v2.2.8** (Current Stable)
 
-- 🎉 **Version Update**: Updated to version 2.2.3.
-- ✨ **Key Updates**: Optimized loading times, refined mobile header layout, and improved dropdown accessibility.
-- ✅ **Stable Release**: Full synchronization of header components with `ViewEncapsulation.None`.
+- 🎉 **Version Update**: Updated to version 2.2.8.
+- 📦 **npm**: Published tarballs again include `fesm2022/` and TypeScript declarations (release pipeline runs `ng build` before publish).
+- 📅 **Range mode**: Optional `allowSameDay` for single-day ranges (double-click same date or close popover after one day).
+- ✅ **Prior fixes**: IANA timezone “Today”, `minDate` normalization, strict typings, and UI polish from v2.2.6 remain included.
 
 ### **v1.9.24**
 
 - 🎉 **Version Update**: Updated to version 1.9.24
-- ✅ **Stable Release**: Version 2.2.3 is the current stable version
+- ✅ **Stable Release**: Version 2.2.8 is the current stable version
 
 ### **v1.9.23**
 
@@ -1311,3 +1315,4 @@ If you find this library helpful, please consider:
 - 💡 **Suggesting** new features
 - 🤝 **Contributing** code improvements
 - 📢 **Sharing** with the community
+

package/docs/API.md

@@ -2,7 +2,7 @@
 
 This document describes the stable public API of ngxsmk-datepicker with comprehensive real-world examples. APIs marked as **stable** are guaranteed to remain backward-compatible within the same major version. APIs marked as **experimental** may change in future releases.
 
-**Version**: 2.2.3+ | **Last updated**: March 9, 2026
+**Version**: 2.2.8+ | **Last updated**: March 21, 2026
 
 ## Stable vs experimental
 
@@ -2403,3 +2403,4 @@ For questions about the API:
 - Check the [README.md](../../README.md) for usage examples
 - Review the [documentation](./) for detailed guides
 - Open an issue on GitHub for questions
+

package/docs/COMPATIBILITY.md

@@ -1,6 +1,6 @@
 # Version Compatibility Matrix
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This document provides comprehensive compatibility information for `ngxsmk-datepicker` across different Angular versions, Zone.js configurations, and SSR/CSR setups.
 
@@ -440,3 +440,4 @@ npm list @angular/core @angular/common @angular/forms
 ### Issue: Translations not working in SSR
 **Solution**: Translations work in SSR. Ensure locale is explicitly set if auto-detection fails on server.
 
+

package/docs/INTEGRATION.md

@@ -1,6 +1,6 @@
 # Integration Guides
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This document provides integration examples for using ngxsmk-datepicker with popular frameworks and libraries.
 
@@ -699,3 +699,4 @@ See the demo app **Integrations** page for a full "Datepicker in a modal" exampl
 - [Theme Guide](./THEME-TOKENS.md)
 - [Locale Guide](./LOCALE-GUIDE.md)
 
+

package/docs/IONIC_INTEGRATION.md

@@ -1,6 +1,6 @@
 # Ionic Framework Integration Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This guide provides step-by-step instructions for integrating ngxsmk-datepicker with Ionic Angular applications.
 
@@ -224,3 +224,4 @@ export class DatepickerPage {
 - [Ionic Theming](https://ionicframework.com/docs/theming/basics)
 - [Capacitor Keyboard Plugin](https://capacitorjs.com/docs/apis/keyboard)
 
+

package/docs/IONIC_TESTING.md

@@ -1,6 +1,6 @@
 # Ionic Integration Testing Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This document provides comprehensive testing instructions for verifying ngxsmk-datepicker compatibility with Ionic Framework.
 
@@ -144,3 +144,4 @@ jobs:
 3. **Test in your Ionic app** with real use cases
 4. **Report issues** with detailed information
 
+

package/docs/LOCALE-GUIDE.md

@@ -1,6 +1,6 @@
 # Locale Packs & i18n Contributor Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 Guide for adding locale support and contributing translations to ngxsmk-datepicker.
 
@@ -296,3 +296,4 @@ If you encounter issues with a specific locale or want to contribute improvement
 
 **Thank you for contributing to ngxsmk-datepicker's internationalization!**
 
+

package/docs/PLUGIN-ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Plugin Architecture
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ngxsmk-datepicker features a powerful **plugin architecture** that allows you to extend and customize the component's behavior without modifying its core code. This architecture is built on a **hook-based system** that provides extension points throughout the component's lifecycle.
 
@@ -926,3 +926,4 @@ The plugin architecture in ngxsmk-datepicker provides:
 
 For more examples and detailed hook documentation, see [Extension Points Guide](./extension-points.md).
 
+

package/docs/SEO.md

@@ -1,6 +1,6 @@
 # SEO Optimization Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This document outlines the SEO optimizations implemented for ngxsmk-datepicker to improve search engine visibility and discoverability.
 
@@ -210,3 +210,4 @@ ngxsmk-datepicker has been optimized for search engines with comprehensive meta
 - [Twitter Cards](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards)
 - [Web.dev SEO Guide](https://web.dev/learn/seo/)
 
+

package/docs/SSR-EXAMPLE.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Example
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 Complete example demonstrating ngxsmk-datepicker with Angular Universal (SSR).
 
@@ -423,3 +423,4 @@ test('datepicker works after SSR hydration', async ({ page }) => {
 - [SSR Best Practices](https://angular.io/guide/universal#best-practices)
 - [Platform Detection](https://angular.io/api/common/isPlatformBrowser)
 
+

package/docs/THEME-TOKENS.md

@@ -1,6 +1,6 @@
 # Theme Tokens & CSS Custom Properties
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 Complete reference for all CSS custom properties (CSS variables) available in ngxsmk-datepicker.
 
@@ -320,3 +320,4 @@ CSS custom properties are supported in all modern browsers:
 
 For older browsers, consider using a CSS custom properties polyfill or provide fallback values.
 
+

package/docs/TIMEZONE.md

@@ -1,6 +1,6 @@
 # Timezone Support
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ## Overview
 
@@ -291,3 +291,4 @@ if (isValidTimezone('America/New_York')) {
 - For advanced operations, consider date-fns-tz or Luxon
 - Always send UTC timestamps to servers/APIs
 
+

package/docs/extension-points.md

@@ -1,6 +1,6 @@
 # Extension Points and Hooks
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ngxsmk-datepicker provides comprehensive extension points through the `hooks` input, allowing you to customize rendering, validation, keyboard shortcuts, formatting, and event handling.
 
@@ -415,3 +415,4 @@ import {
 } from 'ngxsmk-datepicker';
 ```
 
+

package/docs/signal-forms.md

@@ -1,6 +1,6 @@
 # Signal Forms Integration
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 This guide covers using ngxsmk-datepicker with Angular 21+ Signal Forms API.
 
@@ -596,3 +596,4 @@ If `form().dirty()` returns `false` after selecting a date:
 
 4. **Check dev console warnings**: In development mode, the datepicker logs warnings if it falls back to direct signal mutation, which may not track dirty state correctly.
 
+

package/docs/signals.md

@@ -1,6 +1,6 @@
 # Signals Integration Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ngxsmk-datepicker is fully compatible with Angular Signals, providing seamless integration with both traditional reactive forms and modern signal-based patterns.
 
@@ -262,3 +262,4 @@ dateSignal = signal<DatepickerValue>(null);
 
 The datepicker supports both patterns simultaneously, so you can migrate gradually.
 
+

package/docs/ssr.md

@@ -1,6 +1,6 @@
 # Server-Side Rendering (SSR) Guide
 
-**Last updated:** March 9, 2026 · **Current stable:** v2.2.3
+**Last updated:** March 21, 2026 · **Current stable:** v2.2.8
 
 ngxsmk-datepicker is fully compatible with Angular Universal and server-side rendering. This guide covers SSR setup, best practices, and troubleshooting.
 
@@ -301,3 +301,4 @@ export class SSRExampleComponent {
 - [Angular SSR Documentation](https://angular.dev/guide/ssr)
 - [Platform Detection](https://angular.dev/api/common/isPlatformBrowser)
 
+